Versionnement API v1
Les routes partenaires stables sont versionnées sous /v1. Les ruptures passent par une nouvelle version; des champs additifs peuvent apparaître sans changement de version.
Intégrations
API et intégrations (sur demande)
La plupart des clients commencent par devis et coordination répartition. Les programmes à fort volume peuvent discuter API, webhooks et ERP avec notre équipe — documentation disponible pour revue technique.
Démarrage rapide
Trois étapes pour votre premier appel
Étape 1
Lire le guide partenaire
Authentification, URL de base et points de terminaison API v1 pour devis → réservation → suivi.
Étape 2
Importer Postman
Collection v2.1 avec base_url, jeton Bearer (dev en local) et X-Api-Key pour merchant-api.
Étape 3
Créer des clés dans le portail marchand
Générez des clés sandbox, configurez les webhooks et consultez les limites par palier.
Hôte API : porterchain.com — définissez NEXT_PUBLIC_PORTERCHAIN_API_URL en local (http://localhost:8001).
Documentation
Tout pour intégrer
Guide API partenaire
Guide partenaire canonique — authentification, versionnement, flux devis à livraison et préparation production.
Collection Postman
porterchain.postman.json — devis, réservation, marchand, chauffeur et webhooks.
OpenAPI en direct
/docs interactif et openapi.json — vérité des routes pour tous les environnements.
Webhooks et HMAC
Signature des événements sortants, nouvelles tentatives et configuration marchande.
Clés API et sandbox
Créez des clés à portée et basculez le mode sandbox depuis les intégrations marchandes.
API v1
Chemins d'intégration principaux
| Flux | Méthode | Chemin |
|---|---|---|
| Devis instantané | POST | /v1/quotes |
| Créer une réservation | POST | /v1/bookings |
| Suivi public | GET | /v1/orders/{tracking_number}/tracking |
| API marchande | GET | /v1/merchant-api/orders |
Opérations API
Versionnement, limites et attentes webhooks
Limites par forfait
Le sandbox et Growth utilisent des limites prudentes. Business et Enterprise obtiennent des limites plus élevées après revue d'intégration.
Livraison des webhooks
Les événements sortants utilisent signatures, fenêtres de nouvelle tentative et points de terminaison marchands pour réconcilier les statuts.
Besoin d'une revue d'intégration?
Notre équipe aide au cadrage, aux clés sandbox et à la vérification des webhooks avant la mise en production.