Documentation de l’API

L’API REST de LanceOS donne accès à vos clients, vos projets et vos factures depuis vos outils et vos scripts. Elle est disponible avec les formules Pro et Atelier.

Authentification

Chaque requête porte un en-tête Authorization avec votre clé API.

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

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

Pagination

Les listes se paginent avec 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

La liste de vos clients.

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

POST /api/v1/clients

Crée un client.

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

Projets

GET /api/v1/projects

La liste de vos projets, filtrable par statut.

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

Statuts : DRAFT, IN_PROGRESS, ON_HOLD, REVIEW, COMPLETED, CANCELLED, ARCHIVED

Factures

GET /api/v1/invoices

Vos factures et devis, filtrables par statut et par type.

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

POST /api/v1/invoices

Crée une facture en brouillon.

curl -X POST -H "Authorization: Bearer los_..." \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "clx...",
    "items": [
      { "description": "Développement web", "quantity": 5, "unit": "jour", "unitPrice": 500, "tvaRate": 20 }
    ],
    "dueDate": "2026-12-31"
  }' \
  https://lanceos.eu/api/v1/invoices

Le numéro et les montants ne s’envoient pas : LanceOS attribue le numéro suivant, sans trou, et calcule les totaux. Champs facultatifs : projectId, notes, operationType, et pour chaque ligne remiseType et remiseValue. La création compte dans le quota mensuel de factures de votre formule.

Types : INVOICE, QUOTE

Codes d’erreur

Code	Signification
`400`	Paramètres invalides
`401`	Clé API manquante ou invalide
`402`	Quota mensuel atteint pour votre formule
`403`	Formule sans accès à l’API (Pro ou Atelier requis)
`404`	Ressource introuvable
`429`	Limite de requêtes dépassée (1 000 par jour)