Documentation SimpleAPI

Stockez et interrogez vos données JSON en quelques minutes, sans base de données à configurer.

01Démarrage rapide

En 3 étapes, créez votre première ressource et interrogez-la.

1 Créez un espace

Rendez-vous sur Mes espaces et cliquez sur Nouvel espace. Donnez-lui un nom unique (ex : monsupersite). Deux clés API sont générées automatiquement : default et admin.

2 Créez votre première ressource

Envoyez un POST à /votre-ressource/votre-identifiant avec votre clé API.

POST https://api.simpleapi.fr/produit/abc123
Content-Type: application/json
X-API-KEY: votre-clé-api

{
  "nom": "Chaise en bois",
  "prix": 49.90,
  "stock": 12
}

L'API répond 200 OK. La ressource est créée (ou mise à jour si elle existait déjà).

3 Récupérez vos données

GET https://api.simpleapi.fr/produit/abc123
Accept: application/json
X-API-KEY: votre-clé-api

Réponse — 200 OK

{
  "nom": "Chaise en bois",
  "prix": 49.90,
  "stock": 12
}

ℹ Prochaine étape : Lisez le Guide de configuration pour apprendre à gérer vos espaces, vos clés API et les niveaux d'accès. Ou plongez directement dans la Référence API pour explorer toutes les opérations disponibles.

02Présentation

SimpleAPI est une API REST générique hébergée. Elle vous permet de stocker et interroger des données JSON structurées librement, sans créer ni gérer de base de données ou d'infrastructure.

Comment ça fonctionne ?

🔑 Clé API

Chaque requête est authentifiée avec une clé API transmise dans l'en-tête X-API-KEY ou API-KEY. La clé détermine l'espace et le niveau d'accès.

🗄️ Espace isolé

Chaque espace possède son propre schéma de base de données. Les données de vos projets ne se mélangent jamais.

📦 Ressources libres

Le chemin d'URL définit la ressource : /produit/123, /article/slug… Aucun schéma à déclarer au préalable.

Structure de l'URL

Pattern

https://api.simpleapi.fr/ressource/identifiant
https://api.simpleapi.fr/parent/id-parent/enfant/id-enfant

Cas d'usage typiques

Prototype ou MVP rapide avec persistence JSON
Backend léger pour application front-end (CMS, catalogue, blog)
Stockage de configuration ou de préférences utilisateur
API multi-utilisateurs avec authentification JWT intégrée