API Reference

L'API REST LanceOS vous permet d'accéder à vos données clients, projets et factures depuis vos outils et scripts. Disponible avec les plans Pro et Business.

Authentification

Toutes les requêtes doivent inclure un header Authorization avec votre clé API.

curl -H "Authorization: Bearer los_votre_cle_api" \
  https://lanceos.eu/api/v1/clients

Créez vos clés API dans Paramètres → API. Limite : 1 000 requêtes/jour.

Pagination

Tous les endpoints de liste supportent la pagination via les paramètres page et limit.

GET /api/v1/clients?page=2&limit=10

# Réponse
{
  "data": [...],
  "total": 42,
  "page": 2,
  "limit": 10
}

Clients

GET/api/v1/clients, Liste tous vos clients.

curl -H "Authorization: Bearer los_..." \
  https://lanceos.eu/api/v1/clients

POST/api/v1/clients, Crée un nouveau client.

curl -X POST -H "Authorization: Bearer los_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Martin Dupont",
    "email": "[email protected]",
    "company": "Dupont SARL",
    "status": "PROSPECT"
  }' \
  https://lanceos.eu/api/v1/clients

Projets

GET/api/v1/projects, Liste tous vos projets. Filtrable par status.

curl -H "Authorization: Bearer los_..." \
  "https://lanceos.eu/api/v1/projects?status=IN_PROGRESS"

Statuts : DRAFT, IN_PROGRESS, REVIEW, COMPLETED, CANCELLED

Factures

GET/api/v1/invoices, Liste vos factures et devis. Filtrable par status et type.

curl -H "Authorization: Bearer los_..." \
  "https://lanceos.eu/api/v1/invoices?type=INVOICE&status=PAID"

POST/api/v1/invoices, Crée une nouvelle facture.

curl -X POST -H "Authorization: Bearer los_..." \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "clx...",
    "number": "FACT-2026-042",
    "type": "INVOICE",
    "items": [
      {"description": "Développement web", "quantity": 5, "unitPrice": 500, "total": 2500}
    ],
    "subtotal": 2500,
    "taxRate": 20,
    "total": 3000,
    "dueDate": "2026-04-30"
  }' \
  https://lanceos.eu/api/v1/invoices

Types : INVOICE, QUOTE
Statuts : DRAFT, SENT, PAID, OVERDUE, CANCELLED

Codes d'erreur

Code	Description
401	Clé API manquante ou invalide
403	Plan insuffisant (Pro ou Business requis)
404	Ressource introuvable
429	Limite de requêtes dépassée (1 000/jour)
400	Paramètres invalides