Développeurs

API Captain Driver

Obtenez un prix, créez des commandes et suivez vos missions depuis vos propres outils. L’accès est réservé aux entreprises partenaires API : déposez votre demande (Kbis, RIB, usage prévu) depuis votre espace client; une fois validée par notre équipe, vous y créez vos clés et déclarez vos adresses de webhooks.

Webhooks : chaque évènement (convoyeur mandaté, prise en charge, incident, livraison, annulation, facture…) est envoyé en POST signé HMAC-SHA-256 (en-tête Captain-Driver-Signature), avec un identifiant unique et de nouveaux essais automatiques pendant environ 45 heures. Détail des évènements et exemple de vérification dans la section « Webhooks » ci-dessous.

Spécification OpenAPI 3.1 : /api/v2/openapi.json

Codes d’erreur

Chaque erreur est renvoyée au format application/problem+json, avec un code stable et un identifiant de requête (requestId).

UNAUTHENTICATED 401: Clé API absente, invalide ou expirée.
FORBIDDEN 403: Portée de la clé insuffisante, partenariat non validé, suspendu ou révoqué.
NOT_FOUND 404: Ressource introuvable, y compris celle d’une autre entreprise, ou adresse inconnue de l’API.
VALIDATION 422: Données invalides : le détail par champ figure dans details.
PRICING 422: Prix impossible à calculer pour cette demande.
IDEMPOTENCY_MISMATCH 422: Même Idempotency-Key avec un contenu différent.
CONFLICT 409: Opération impossible dans l’état actuel de la ressource.
RATE_LIMITED 429: Trop de requêtes : réessayez dans un instant.
UNAVAILABLE 503: Service extérieur momentanément indisponible : réessayez.
INTERNAL 500: Erreur interne : réessayez, puis contactez-nous avec le requestId.