API de transport
Développez sur l'API qui fait tourner Roadmark.
Nos propres écrans, l'application chauffeur et chaque agent appellent la même API publique. Il n'y en a pas de privée. Tout ce que Roadmark peut faire à un chargement, à une soumission ou à une facture, votre code peut le faire aussi, avec les mêmes autorisations.
GET /v1/loads/48213
Roadmark-Company: ashgrove-freight
200 OK
{
"id": "48213",
"object": "load",
"status": "delivered",
"customer": { "id": "prairie-foods", "name": "Prairie Foods" },
"equipment": { "type": "dry_van", "length_ft": 53, "trailer": "TRL 5317" },
"stops": [
{ "type": "pickup", "location": "Mississauga, ON", "appointment_at": "2026-09-29T06:00:00-04:00" },
{ "type": "delivery", "location": "Joliet, IL", "appointment_at": "2026-09-29T14:45:00-05:00" }
],
"rate": { "amount": "4215.00", "currency": "USD" },
"invoice": { "id": "INV-10442", "total": "4315.00" },
"version": 8,
"updated_at": "2026-09-29T18:21:07-05:00"
}
POST https://hooks.ashgrove.example/roadmark
Roadmark-Signature: t=1790722840,v1=5b3f2a…
{
"id": "evt_01J9M3QZ",
"object": "event",
"type": "load.status_changed",
"created_at": "2026-09-29T18:00:40-05:00",
"company": "ashgrove-freight",
"data": {
"id": "48213",
"object": "load",
"status": "delivered",
"previous_status": "in_transit",
"version": 7
}
}
// Claude, ChatGPT or Gemini: connector settings
{
"mcpServers": {
"roadmark": {
"url": "https://mcp.roadmark.ai/v1",
"auth": "oauth"
}
}
}
Chaque personne se connecte une fois; l'assistant agit ensuite en son nom.
Chaque dossier qu'utilise le produit est dans l'API.
loadsUn envoi, de la cueillette à la livraison, avec ses arrêts et son statut.stopsUne cueillette, une livraison ou un arrêt intermédiaire, et sa plage de rendez-vous.quotesUne demande chiffrée, en ébauche ou envoyée, avec les raisons derrière le chiffre.ordersLa réservation d'un client avant qu'elle devienne un chargement.customersLes clients que vous facturez, leurs contrats et leurs contacts.carriersLes transporteurs que vous engagez, leurs assurances, leurs corridors et l'historique de leurs tarifs.driversHeures de service, documents et paie, pour votre propre parc.unitsCamions et remorques, leur entretien et leur chargement en cours.invoicesCe que vous facturez à un client, et la date du paiement.settlementsCe qui est dû à un chauffeur ou à un transporteur, et la date du paiement.documentsPreuves de livraison, confirmations de tarif et tout autre document joint à un chargement.eventsChaque modification de chaque dossier, et qui ou quoi l'a faite.
Événements et webhooks
Les webhooks avisent vos systèmes dès qu'un chargement change.
Abonnez un point de terminaison aux événements qui vous intéressent. Chacun transporte l'identifiant du dossier et sa version : une nouvelle tentative tardive n'écrase jamais une donnée plus récente, et vous pouvez toujours récupérer le dossier complet avec les autorisations de votre propre clé.
quote.draftedUn agent ou une personne crée une soumission pour un appel d'offres ou une demande reçue.quote.sentUne soumission est envoyée à un client.load.status_changedUn chargement passe de réservé à réparti, en transit, puis livré.load.stop.arrivedUn appel de suivi, un balayage ou un événement du DCE indique l'arrivée à un arrêt.tender.acceptedUn transporteur accepte une offre de chargement dans le portail transporteur ou par EDI.invoice.issuedUne facture est créée à partir d'un chargement livré.settlement.paidLe règlement d'un chauffeur ou d'un transporteur est payé.document.uploadedUne preuve de livraison, une confirmation de tarif ou un autre document est ajouté à un chargement.
Le même serveur MCP qu'utilisent Claude, ChatGPT et Gemini.
search_loadsTrouver des chargements par client, corridor, statut ou date, comme un répartiteur le demanderait.get_loadLire un chargement au complet : arrêts, statut, tarif et documents.draft_quoteChiffrer un corridor à partir des contrats et de l'historique des tarifs, et laisser le résultat en ébauche.update_etaConsigner une nouvelle HAP à partir d'un appel de suivi ou d'un retard, préparée pour approbation comme toute autre mise à jour.list_invoicesTrouver les factures ouvertes, payées ou en souffrance d'un client.find_customerConsulter le contrat, les contacts et les chargements récents d'un client.
Créez votre propre agent
Les agents que vous créez préparent le travail, et une personne l'approuve dans le même dossier.
Tout ce que vous développez sur l'API écrit dans les mêmes ébauches que nos propres agents. Rien de ce qu'il prépare ne parvient à un client, à un transporteur ou à un chauffeur tant que quelqu'un ne l'a pas approuvé dans Roadmark, et chaque action est attribuée à votre intégration, nommément.
- 09:14integration:ashgrove-sms a préparé un appel de suivi à partir du texto de R. Diaz : dédouané à Port Huron à 9 h 05
- 09:16K. Wong l'a approuvé; Prairie Foods le voit sur la page de suivi
Un bac à sable avec un vrai groupe déjà dedans.
Utilisez l’API REST et JSON avec des clients typés pour Node.js, Python et Ruby.
Questions
Ce que demandent les développeurs.
Roadmark a-t-il une API publique?
Oui, et c'est la même API qu'appellent les écrans, l'application chauffeur et les agents de Roadmark; il n'y en a pas de privée. Tout ce que Roadmark peut faire à un chargement, à une soumission ou à une facture, votre code peut le faire aussi, avec les mêmes autorisations.
Quelles données l'API couvre-t-elle?
Chaque dossier qu'utilise le produit : chargements, arrêts, soumissions, commandes, clients, transporteurs, chauffeurs, unités, factures, règlements, documents et événements. C'est le même modèle de ressources que lisent les écrans.
Roadmark prend-il en charge les webhooks?
Oui. Abonnez un point de terminaison à des événements comme quote.sent, load.status_changed, tender.accepted ou invoice.issued. Chaque événement transporte l'identifiant et la version du dossier : une nouvelle tentative tardive n'écrase jamais une donnée plus récente.
Y a-t-il un serveur MCP?
Oui, le même qu'utilisent Claude, ChatGPT et Gemini. C'est un petit ensemble d'outils en mots simples, comme search_loads, draft_quote et list_invoices, et chaque appel s'exécute au nom de la personne connectée, qui ne voit que ses entreprises et ses clients.
Y a-t-il un bac à sable pour les tests?
Oui, et l'accès est gratuit. Les clés de test pointent vers Ashgrove Transportation Group, un espace de test avec des entreprises, des chargements, des clients et des transporteurs déjà chargés, et rien de ce que vous y faites n'atteint une entreprise réelle.
Y a-t-il des SDK?
Oui. Des clients typés sont disponibles pour Node.js, Python et Ruby. Vous pouvez aussi utiliser directement l’API REST et JSON.
Obtenez un bac à sable.
Nous vous fournirons des clés de test sur l’espace de test Ashgrove pour que vous puissiez commencer à développer le jour même, avec un soutien en français ou en anglais.
- Des clés de test, sans entreprise réelle en jeu
- L'API complète, les webhooks et le serveur MCP
- Un développeur, pas un vendeur, à l'appel