Plateforme développeurs

Développez sur
CouthActs.

Une API Agents et un serveur MCP pour les assistants IA, une API Prestataires pour les systèmes de répartition et de télématique, et des endpoints publics pour vérifier les registres de traçabilité signés. Du JSON simple sur HTTPS avec des clés bearer.

Obtenir des clés API Nous contacter

Clés et limites

Choisissez votre clé.

Clés d’agent

Sans frais d’abonnement

Pour les agents et assistants IA qui agissent pour un compte client.

Les autorisations que vous choisissez : devis, missions, réservations, portefeuille et confiance
Plafonds de dépense par mission et mensuels, plus un seuil d’approbation
Jusqu’à 120 requêtes par minute et par clé
À créer dans Paramètres → Agents IA, ou connectez un assistant via OAuth

Créer une clé d’agent

API Prestataires

Offre Basic

Pour les prestataires qui connectent leurs propres systèmes de répartition ou de télématique.

Basic : 500 appels par mois, au-delà les appels sont refusés
Missions ouvertes, vos réservations, votre portefeuille et vos mises à jour de position
Professional (5 000 appels par mois) et Enterprise : bientôt disponibles
Créez vos clés dans Paramètres → Clés API prestataire

Gérer les clés prestataire

API Clients

Sur accord

Des endpoints REST pour les missions, offres et portefeuille d’un client.

Starter : 1 000 appels par mois, au-delà les appels sont refusés
Growth : 5 000 appels par mois, puis 0,20 US$ par appel, prélevés sur votre Portefeuille le mois suivant
Enterprise : limites convenues
Les clés ne sont pas encore en libre-service ; la plupart des clients devraient plutôt utiliser une clé d’agent

Nous contacter

Les offres payantes de l’API Prestataires (Professional et Enterprise) arrivent bientôt ; contactez-nous si vous avez besoin de limites plus élevées dès maintenant. Votre offre actuelle et votre consommation sont indiquées dans les Paramètres. Les API sont fournies sans engagement de niveau de service.

Démarrage rapide

Trois étapes jusqu’à votre premier appel.

Étape 01

Obtenez votre clé

Clients et agents IA : Paramètres → Agents IA. Prestataires : Paramètres → Clés API prestataire. La clé complète n’est affichée qu’une fois, à sa création.

Étape 02

Faites votre première requête

Envoyez votre clé dans Authorization: Bearer. Les prestataires peuvent commencer par GET /api/provider/v1/jobs.

Étape 03

Découvrez les outils pour agents

Clés d’agent : consultez la description OpenAPI sur /api/agent/openapi.json, ou connectez un client MCP à /api/mcp.

Exemple de requête

curl -X GET https://couthacts.com/api/provider/v1/jobs \
  -H "Authorization: Bearer ca_provider_your_key_here" \
  -H "Content-Type: application/json"

# Response
{
  "success": true,
  "data": [
    {
      "id": "clx...",
      "mode": "FREIGHT_TRUCKING",
      "title": "Freight: Dallas, TX → Houston, TX",
      "status": "OPEN",
      "originAddress": "Dallas, TX",
      "destinationAddress": "Houston, TX",
      "pickupDate": "2026-11-05T08:00:00.000Z",
      "budgetUsd": "2500",
      "insuranceTier": "NONE",
      "_count": { "bids": 3 }
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1, "pages": 1, "requestId": "…", "timestamp": "…" }
}

Endpoints

Référence complète.

Tous les montants des réponses de l’API, des agents et de MCP sont en USD (champs se terminant par Usd) : CouthActs facture et verse uniquement en USD. Pour afficher un équivalent local, appelez GET /api/currency/display une fois par écran et multipliez : local ≈ amountUsd × rate. Affichez d’abord le montant en USD, puis le montant local comme estimation.

API Agents et MCP

GET/api/agent/v1/tools
Liste les actions autorisées pour votre clé d’agent, avec leurs schémas d’entrée.
Clé d’agent
POST/api/agent/v1/tools/{name}
Exécute une action (par exemple get_quote ou post_job) dans le respect des autorisations, plafonds de dépense et règles d’approbation de votre clé.
Clé d’agent
GET/api/agent/openapi.json
Description OpenAPI 3.1 des outils pour agents.
Aucune
POST/api/mcp
Les mêmes actions via le Model Context Protocol, pour Claude, ChatGPT et les autres assistants compatibles MCP.
Clé d’agent / OAuth

API Prestataires

GET/api/provider/v1/jobs
Missions ouvertes dans vos modes de transport enregistrés (filtrables par mode ; paginées).
Clé API prestataire
GET/api/provider/v1/bookings
Vos réservations avec leur statut, leur code de suivi et l’état du blocage du paiement.
Clé API prestataire
POST/api/provider/v1/tracking
Signale une position pour une réservation active ; elle est montrée au client et inscrite dans le Registre de traçabilité.
Clé API prestataire
GET/api/provider/v1/wallet
Le solde de votre portefeuille et vos transactions récentes.
Clé API prestataire

API Clients

GET · POST/api/v1/jobs
Liste vos missions ou publie une mission (prélève les frais et bloque le budget sur votre Portefeuille).
Clé API client
GET · PATCH/api/v1/jobs/{id}
Consulte une mission, modifie son budget ou sa description, ou l’annule.
Clé API client
GET · POST/api/v1/bids
Liste les offres reçues sur vos missions, ou accepte ou refuse une offre.
Clé API client
GET/api/v1/wallet
Le solde de votre portefeuille.
Clé API client

Publics (sans clé)

GET/api/track/{code}
Statut, itinéraire et événements de suivi d’une réservation à partir de son code de suivi. Aucune donnée financière.
Aucune
GET/api/custody/public/{trackingCode}
Preuve publique que le Registre de traçabilité d’une réservation est intact (types d’événements, horodatages, hachages et signatures).
Aucune
GET/api/credentials/provider/{id}
Le justificatif signé d’un prestataire (statut de vérification et historique).
Aucune
GET/.well-known/couthacts-keys.json
Les clés publiques Ed25519 de CouthActs pour vérifier les signatures.
Aucune
POST/api/trust/verify
Vérifie un certificat de traçabilité ou un justificatif de prestataire.
Aucune
GET/api/currency/display
La devise d’affichage de l’utilisateur et son taux par rapport à l’USD (rate vaut null sans taux en direct : affichez uniquement l’USD).
Aucune
GET/api/currency/supported
Devises d’affichage pour un sélecteur : code, nom, symbole et décimales.
Aucune

Suivi par le prestataire

Signalez la position depuis vos systèmes.

Envoyez une position pour une réservation confirmée ou en cours. Elle est montrée au client en temps réel et inscrite comme point de passage dans le Registre de traçabilité signé. Vous pouvez indiquer la provenance de chaque relevé avec un nom de couche. CouthActs enregistre ce libellé, mais ne se connecte pas lui-même aux flux AIS, de vol, ELD, de capteurs ou satellite, et ne les vérifie pas : les données sont celles que vous transmettez.

Libellés de couche acceptés

MOBILE_GPS

GPS mobile

Une position GPS d’un téléphone ou du véhicule (par défaut).

AIS_MARITIME

AIS (maritime)

La position d’un navire issue de votre source AIS.

FLIGHT_TRACKING

Suivi de vol

La position d’un aéronef issue de votre source de suivi de vol.

ELD_INTEGRATION

ELD

La position d’un camion issue de votre enregistreur électronique.

QR_PIN_CONFIRMATION

Remise par PIN

Une position au moment de la remise. Le PIN de livraison lui-même est saisi dans l’application.

IOT_DEVICE

Objet connecté

Une position issue de votre traceur. Les mesures des capteurs ne sont pas enregistrées.

SATELLITE

Satellite

Une position issue de votre traceur satellite.

DOCUMENT_POD_AI

Preuve de livraison

Simple libellé de position. CouthActs n’analyse pas de documents.

BIOMETRIC

Biométrie

Simple libellé de position. CouthActs n’effectue aucun contrôle biométrique à la remise.

Signaler une position

POST /api/provider/v1/tracking
Authorization: Bearer ca_provider_your_key_here
Content-Type: application/json

{
  "bookingId": "clx...",
  "lat": 32.7767,
  "lng": -96.7970,
  "layer": "MOBILE_GPS",
  "status": "IN_TRANSIT",
  "note": "Departed Dallas warehouse"
}

Authentification et sécurité

Comment l’accès est contrôlé.

Clés bearer

Chaque requête nécessite Authorization: Bearer. Les clés sont créées dans les Paramètres, affichées une seule fois et révocables à tout moment.

HTTPS uniquement

N’envoyez vos clés que via HTTPS. Ne les intégrez jamais dans du code public ou des applications côté client.

Limites

Clés d’agent : 120 requêtes par minute. Clés API prestataire et client : le nombre d’appels mensuels de leur offre, indiqué dans les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining.

Journal d’activité

Chaque action d’agent est journalisée avec l’outil, le statut, le montant, les entrées et le résultat, et affichée dans les Paramètres. Les clés prestataire indiquent leur nombre de requêtes et leur dernière utilisation.

Plafonds de dépense et approbations

Les clés d’agent ne peuvent pas dépasser leur plafond par mission ou mensuel, et les actions au-delà du seuil d’approbation attendent l’accord du titulaire (les demandes expirent après 72 heures).

Des registres signés, pas des requêtes signées

Les Registres de traçabilité et les justificatifs de prestataires sont signés avec la clé Ed25519 de CouthActs, afin que chacun puisse les vérifier. Les requêtes et réponses de l’API ne sont pas signées, et CouthActs n’envoie pas de webhooks sortants.

Format de réponse

Cohérent. Prévisible.

Les réponses des API Prestataires et Clients suivent le format ci-dessous. Les réponses de l’API Agents comportent à la place les champs status, actionId et result ; voir la description OpenAPI.

Succès (2xx)

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

Erreur (4xx/5xx)

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "bookingId, lat, lng required"
  },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

Développeurs bienvenus

Prêt à intégrer ?

Créez une clé dans les Paramètres et faites votre premier appel en quelques minutes. Pour des limites plus élevées ou une offre Enterprise, contactez-nous.

Obtenir des clés API Nous contacter

Développez surCouthActs.

Choisissez votre clé.

Clés d’agent

API Prestataires

API Clients

Trois étapes jusqu’à votre premier appel.

Obtenez votre clé

Faites votre première requête

Découvrez les outils pour agents

Référence complète.

API Agents et MCP

API Prestataires

API Clients

Publics (sans clé)

Signalez la position depuis vos systèmes.

Libellés de couche acceptés

GPS mobile

AIS (maritime)

Suivi de vol

ELD

Remise par PIN

Objet connecté

Satellite

Preuve de livraison

Biométrie

Comment l’accès est contrôlé.

Clés bearer

HTTPS uniquement

Limites

Journal d’activité

Plafonds de dépense et approbations

Des registres signés, pas des requêtes signées

Cohérent. Prévisible.

Prêt à intégrer ?

Développez sur
CouthActs.