API REST v1

Accédez à vos clients, factures et services par programmation. Toutes les requêtes sont authentifiées par clé API et renvoient du JSON.

Authentification

Passez votre clé dans l'en-tête Authorization. Générez vos clés dans la console (Système → Clés API).

curl https://app.nebula.io/api/v1/clients \
  -H "Authorization: Bearer nbl_live_demo0000000000000000demo"

Limite : 60 requêtes/minute par clé (en-têtes X-RateLimit-*).

Endpoints

GET/api/v1/meVérifie la clé et renvoie les informations de l'API.

GET/api/v1/clientsListe les clients (paramètres : limit, offset).

GET/api/v1/clients/{id}Récupère un client par id, code ou slug.

GET/api/v1/invoicesListe les factures (paramètres : status, limit).

GET/api/v1/servicesListe les services provisionnés.

Exemple de réponse

{
  "object": "list",
  "total": 8,
  "limit": 20,
  "offset": 0,
  "data": [
    {
      "id": "clx…",
      "code": "#C-1284",
      "name": "Lina Moreau",
      "email": "lina.moreau@gmail.com",
      "status": "active",
      "currency": "EUR",
      "balance_cents": 0,
      "spent_cents": 124000
    }
  ]
}

NebulaWHMCS · API REST v1