L’API Novadesko

Authentification

Toutes les requêtes à l’API nécessitent un jeton dans l’en-tête HTTP :

Authorization: Bearer {token}
        

Pour obtenir un token :

curl -X POST https://api.novadesko.com/api/login \
  -H "Content-Type: application/json" \
  -d '{"email":"john@doe.com","password":"secret"}'
        

{
  "email": "john@doe.com",
  "password": "secret"
}
            

{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOi..."
}
            

Documents

Gérer tous types de documents : factures, devis, avoirs, etc. Remplacez invoices par le type désiré.

• GET /api/{slug} — Lister les documents
• POST /api/{slug} — Créer un document
• GET /api/{slug}/{id} — Détail d’un document
• PUT /api/{slug}/{id} — Modifier
• DELETE /api/{slug}/{id} — Supprimer

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/invoices
        

[
  {
    "id": 123,
    "number": "F2024-0001",
    "date": "2024-06-12",
    "client": { "id": 1, "name": "ACME Sarl" },
    "total": 1200.00,
    "status": "paid"
  }
]
            

{
  "client_id": 1,
  "date": "2024-06-12",
  "lines": [
    { "product_id": 15, "qty": 2, "price": 100 }
  ]
}
            

Clients

Gérer votre base de clients.

• GET /api/customers — Lister les clients
• POST /api/customers — Créer un client
• GET /api/customers/{id} — Détail d’un client
• PUT /api/customers/{id} — Modifier
• DELETE /api/customers/{id} — Supprimer

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/customers
        

{
  "name": "Société Demo",
  "email": "contact@demo.com",
  "phone": "+33 1 23 45 67 89"
}
            

{
  "id": 2,
  "name": "Société Demo",
  "email": "contact@demo.com",
  "created_at": "2024-06-12T16:10:00Z"
}
            

Fournisseurs

Gérez vos fournisseurs et leurs informations.

• GET /api/suppliers — Lister les fournisseurs
• POST /api/suppliers — Créer un fournisseur
• GET /api/suppliers/{id} — Détail d’un fournisseur

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/suppliers
        

{
  "company": "Fournisseur SARL",
  "vat_number": "FR123456789",
  "email": "info@fournisseur.com"
}
            

{
  "id": 5,
  "company": "Fournisseur SARL",
  "created_at": "2024-06-12T16:22:00Z"
}
            

Produits

Gérer le catalogue de produits vendus.

• GET /api/products — Lister les produits
• POST /api/products — Créer un produit
• GET /api/products/{id} — Détail d’un produit

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/products
        

{
  "name": "Abonnement Pro",
  "price": 49.99,
  "category_id": 1
}
            

{
  "id": 42,
  "name": "Abonnement Pro",
  "price": 49.99
}
            

Catégories Produits

Organisez vos produits par catégories.

• GET /api/product-categories — Lister les catégories
• POST /api/product-categories — Créer une catégorie

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/product-categories
        

{
  "name": "Services",
  "parent_id": null
}
            

{
  "id": 7,
  "name": "Services"
}
            

Transactions

Suivre les flux financiers liés à vos documents (paiements, encaissements...).

• GET /api/transactions — Lister les transactions
• POST /api/transactions — Enregistrer une transaction

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/transactions
        

{
  "document_id": 123,
  "amount": 1200.00,
  "date": "2024-06-12",
  "type": "payment"
}
            

{
  "id": 88,
  "document_id": 123,
  "amount": 1200.00,
  "type": "payment",
  "created_at": "2024-06-12T17:00:00Z"
}
            

Webhooks

Recevez des notifications en temps réel lors d’événements clés (nouvelle facture, paiement reçu...).

• POST /webhook — Point d’entrée pour recevoir les notifications

{
  "event": "invoice.paid",
  "data": {
    "id": 123,
    "number": "F2024-0001",
    "amount": 1200.00,
    "client": { "id": 1, "name": "ACME Sarl" }
  }
}