Glossaire
Vocabulaire de l'API de livraison
Chaque terme utilisé par l'API, la console et l'app chauffeur, en une phrase, avec un lien vers là où il compte.
- Acceptation automatiqueVoir →
- Des règles fixées par le chauffeur (distance, tailles, horaires, zones) pour accepter en quelques secondes les offres correspondantes.
- ArrêtVoir →
- Une adresse de retrait ou de dépôt avec contact ; une livraison locale accepte jusqu'à 8 dépôts, une ville à ville jusqu'à 3.
- Blocage et captureVoir →
- Le prix complet est bloqué sur votre portefeuille à la réservation et capturé à la confirmation ; une annulation libère le blocage.
- Carnet d'adressesVoir →
- Lieux de retrait et de dépôt enregistrés avec contacts, utilisables depuis la console et l'API.
- Classe de tailleVoir →
- S (enveloppe ou sac), M (boîte à chaussures à sac à dos), L (valise) ou XL (fourgon requis) ; elle module le prix et filtre les chauffeurs sollicités.
- Clé sandboxVoir →
- Une clé test à générer depuis la page tarifs ou la console pour essayer tout le flux sans rien dépenser.
- ConfirmerVoir →
- Votre acceptation de la preuve, qui capture les fonds ; sans appel de votre part, la livraison se confirme seule 24 h après le dépôt.
- DevisVoir →
- Une offre tarifée et routée pour une livraison, renvoyée par POST /v1/quotes avec détail et ETA ; gratuit, sans clé, valable 15 minutes.
- Forfait retourVoir →
- La part d'un prix ville à ville qui couvre le retour à vide du chauffeur : la moitié de la distance et du temps de conduite de l'aller.
- Heure limite du jour mêmeVoir →
- Une livraison ville à ville doit arriver avant 21 h, heure locale ; une réservation trop tardive pour cela est enlevée le lendemain matin.
- JalonVoir →
- Une étape enregistrée d'une livraison, comme la marchandise à bord au retrait, qui change ce qui reste annulable.
- Lien de suiviVoir →
- Une page publique par livraison avec statut en direct, position du chauffeur et ETA, personnalisable à vos couleurs.
- LivraisonVoir →
- Une mission réservée d'un retrait vers un ou plusieurs dépôts, avec chronologie des statuts, preuve et lien de suivi.
- Livraison récurrenteVoir →
- Un modèle qui se réserve seul aux jours et heures choisis ; géré dans la console et par le worker récurrent.
- MajorationVoir →
- Un multiplicateur en direct quand la demande dépasse l'offre proche ; toujours visible dans le détail du devis.
- Mode testVoir →
- Les clés test créent des livraisons is_test avec des chauffeurs simulés et sans mouvement de portefeuille ; la console les affiche sous une bannière sandbox.
- Note du destinataireVoir →
- La note de 1 à 5 laissée par le destinataire sur la page de suivi après la remise ; les chauffeurs voient leur moyenne.
- OffreVoir →
- Une mission proposée à un chauffeur dans RentADriver Go avec ses détails ; acceptée d'un geste ou automatiquement selon ses règles.
- PortefeuilleVoir →
- Le solde prépayé qui finance une livraison ; rechargez par carte ou USDC et suivez chaque mouvement dans la console.
- Preuve de livraisonVoir →
- Photos géolocalisées, signature ou code à usage unique capturés à la remise et renvoyés par get_proof_of_delivery.
- quote_idVoir →
- L'identifiant d'un devis ; passez-le à create_delivery pour réserver exactement à ce prix.
- Remise par OTPVoir →
- Un code à usage unique placé dans les métadonnées ; le destinataire le lit au chauffeur et la mission ne peut se clore sans lui.
- Serveur MCPVoir →
- rentadriver-mcp, le serveur Model Context Protocol qui expose chaque capacité de l'API comme outils pour un agent.
- Signature de webhookVoir →
- Un en-tête HMAC sur chaque webhook pour vérifier que l'événement vient de RentADriver ; envois de test depuis la console.
- TurnstileVoir →
- La vérification humaine optionnelle des inscriptions depuis un navigateur ; agents, serveur MCP et curl en sont exemptés.
- UrgenceVoir →
- asap, today ou scheduled ; fixe la fenêtre de dispatch et l'un des multiplicateurs de prix.
- Vague de dispatchVoir →
- Une série d'offres envoyée aux chauffeurs en service près du retrait ; le rayon s'élargit vague après vague jusqu'à acceptation.
- Valeur déclaréeVoir →
- value_cents fixé sur un article : enregistré avec la livraison pour évaluer une réclamation en cas de perte ou de dommage.
- Ville à villeVoir →
- Livraison le jour même d'une ville de lancement vers une ville de lancement voisine à 160 km maximum par la route, avec un seul chauffeur dédié.
- Zone de serviceVoir →
- Une ville de lancement avec un centre, un rayon et son propre tarif ; check_coverage refuse les devis hors de toute zone.