API VULKO

Connectez VULKO à votre logiciel comptable, ERP, CRM ou tableau de bord interne via une API REST simple. Réservée au plan Équipe.

1. Obtenir une clé API

Souscrivez au plan Équipe depuis /pricing
Allez dans Paramètres → Connexion avec vos outils
Cliquez sur Générer une clé de connexion
Copiez la clé immédiatement — elle ne sera plus jamais affichée

2. Authentification

Toutes les requêtes nécessitent un en-tête HTTP Authorization: Bearer VOTRE_CLE. Sans clé valide ou si le plan n'est pas Équipe, l'API renvoie 401 ou 403.

Les clés inactives depuis plus de 90 jours sont automatiquement révoquées — pensez à les rafraîchir.

3. Limites

60 requêtes par minute par clé API (réponse 429 avec en-tête Retry-After sinon)
Pagination : limit max 100, défaut 50
Toutes les réponses sont au format JSON UTF-8

4. Endpoints

GET/quotes

Liste les devis de votre entreprise. Filtres : status (DRAFT/SENT/ACCEPTED/REJECTED/EXPIRED), limit (1-100, défaut 50), offset (défaut 0).

curl -H "Authorization: Bearer VOTRE_CLE" \
     "https://vulko.fr/api/v1/quotes?status=ACCEPTED&limit=20"

GET/invoices

Liste les factures. Mêmes filtres que /quotes. Inclut le statut (DRAFT/SENT/PAID/OVERDUE/CANCELLED).

curl -H "Authorization: Bearer VOTRE_CLE" \
     "https://vulko.fr/api/v1/invoices?status=PAID"

GET/clients

Liste les clients. Recherche par q (nom, email ou ville), pagination via limit + offset.

curl -H "Authorization: Bearer VOTRE_CLE" \
     "https://vulko.fr/api/v1/clients?q=dupont"

POST/clients

Crée un nouveau client. Champ obligatoire : name. Optionnels : email, phone, address, city, zipCode, type (PARTICULIER ou PROFESSIONNEL), notes.

curl -X POST \
     -H "Authorization: Bearer VOTRE_CLE" \
     -H "Content-Type: application/json" \
     -d '{"name":"SARL Dupont","email":"contact@dupont.fr","type":"PROFESSIONNEL"}' \
     https://vulko.fr/api/v1/clients

5. Format des erreurs

{
  "error": {
    "code": "validation_error",
    "message": "Le nom du client est requis."
  }
}

Codes possibles : unauthorized, plan_required, validation_error, bad_request, server_error.

Besoin d'aide d'intégration ? Transmettez ce lien à votre prestataire informatique. Pour un accompagnement personnalisé, contactez contact@vulko.fr.