Zum Hauptinhalt springen
Entwicklerplattform

Entwickeln mit
CouthActs.

Eine Agent-API und ein MCP-Server für KI-Assistenten, eine Anbieter-API für Dispositions- und Telematiksysteme und öffentliche Endpunkte zum Prüfen signierter Nachweisprotokolle. Schlichtes JSON über HTTPS mit Bearer-Schlüsseln.

API-Schlüssel erhalten Kontakt aufnehmen

Schlüssel und Limits

Wählen Sie Ihren Schlüssel.

Agent-Schlüssel

Keine Plangebühr

Für KI-Agenten und Assistenten, die für ein Kundenkonto handeln.

  • Berechtigungen nach Ihrer Wahl: Angebote, Aufträge, Buchungen, Wallet und Vertrauen
  • Ausgabenlimits pro Auftrag und pro Monat sowie eine Freigabeschwelle
  • Bis zu 120 Anfragen pro Minute und Schlüssel
  • Erstellen unter Einstellungen → KI-Agenten oder Assistenten per OAuth verbinden
Agent-Schlüssel erstellen

Anbieter-API

Basic-Plan

Für Anbieter, die eigene Dispositions- oder Telematiksysteme anbinden.

  • Basic: 500 Aufrufe pro Monat, danach werden Aufrufe abgelehnt
  • Offene Aufträge, Ihre Buchungen, Ihr Wallet und Standortmeldungen
  • Professional (5.000 Aufrufe pro Monat) und Enterprise: demnächst
  • Schlüssel erstellen unter Einstellungen → Anbieter-API-Schlüssel
Anbieter-Schlüssel verwalten

Kunden-API

Nach Vereinbarung

REST-Endpunkte für die eigenen Aufträge, Angebote und das Wallet eines Kunden.

  • Starter: 1.000 Aufrufe pro Monat, danach werden Aufrufe abgelehnt
  • Growth: 5.000 Aufrufe pro Monat, danach 0,20 US$ pro Aufruf, im Folgemonat von Ihrem Wallet abgebucht
  • Enterprise: Limits nach Vereinbarung
  • Schlüssel gibt es noch nicht per Selbstbedienung; die meisten Kunden sollten stattdessen einen Agent-Schlüssel nutzen
Kontakt aufnehmen

Kostenpflichtige Pläne der Anbieter-API (Professional und Enterprise) kommen bald; kontaktieren Sie uns, wenn Sie schon jetzt höhere Limits brauchen. Ihr aktueller Plan und Ihre Nutzung stehen in den Einstellungen. Die APIs werden ohne Service-Level-Zusage bereitgestellt.

Schnellstart

Drei Schritte zum ersten Aufruf.

Schritt 01

Schlüssel erhalten

Kunden und KI-Agenten: Einstellungen → KI-Agenten. Anbieter: Einstellungen → Anbieter-API-Schlüssel. Der vollständige Schlüssel wird nur einmal bei der Erstellung angezeigt.

Schritt 02

Erste Anfrage senden

Senden Sie Ihren Schlüssel in Authorization: Bearer. Anbieter können mit GET /api/provider/v1/jobs beginnen.

Schritt 03

Agent-Werkzeuge erkunden

Agent-Schlüssel: Lesen Sie die OpenAPI-Beschreibung unter /api/agent/openapi.json oder verbinden Sie einen MCP-Client mit /api/mcp.

Beispielanfrage

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": "…" }
}

Endpunkte

Vollständige Referenz.

Alle Beträge in Antworten der API, der Agenten und von MCP sind in USD (Felder, die auf Usd enden): CouthActs berechnet und zahlt ausschließlich in USD aus. Für einen Gegenwert in Landeswährung rufen Sie GET /api/currency/display einmal pro Ansicht auf und multiplizieren: lokal ≈ amountUsd × rate. Zeigen Sie zuerst den USD-Betrag und den lokalen Betrag als Schätzung.

Agent-API und MCP

  • GET/api/agent/v1/tools

    Listet die Aktionen auf, die Ihr Agent-Schlüssel ausführen darf, mit Eingabeschemata.

    Agent-Schlüssel
  • POST/api/agent/v1/tools/{name}

    Führt eine Aktion aus (z. B. get_quote oder post_job) – im Rahmen der Berechtigungen, Ausgabenlimits und Freigaberegeln Ihres Schlüssels.

    Agent-Schlüssel
  • GET/api/agent/openapi.json

    OpenAPI-3.1-Beschreibung der Agent-Werkzeuge.

    Keine
  • POST/api/mcp

    Dieselben Aktionen über das Model Context Protocol, für Claude, ChatGPT und andere MCP-fähige Assistenten.

    Agent-Schlüssel / OAuth

Anbieter-API

  • GET/api/provider/v1/jobs

    Offene Aufträge in Ihren registrierten Transportarten (nach Transportart filterbar; seitenweise).

    Anbieter-API-Schlüssel
  • GET/api/provider/v1/bookings

    Ihre Buchungen mit Status, Tracking-Code und Status des Zahlungseinbehalts.

    Anbieter-API-Schlüssel
  • POST/api/provider/v1/tracking

    Meldet einen Standort für eine aktive Buchung; er wird dem Kunden angezeigt und im Nachweisprotokoll erfasst.

    Anbieter-API-Schlüssel
  • GET/api/provider/v1/wallet

    Ihr Wallet-Guthaben und Ihre letzten Transaktionen.

    Anbieter-API-Schlüssel

Kunden-API

  • GET · POST/api/v1/jobs

    Listet Ihre Aufträge auf oder schreibt einen Auftrag aus (bucht Gebühren ab und hält das Budget auf Ihrem Wallet ein).

    Kunden-API-Schlüssel
  • GET · PATCH/api/v1/jobs/{id}

    Ruft einen Auftrag ab, ändert Budget oder Beschreibung oder storniert ihn.

    Kunden-API-Schlüssel
  • GET · POST/api/v1/bids

    Listet Angebote zu Ihren Aufträgen auf oder nimmt ein Angebot an bzw. lehnt es ab.

    Kunden-API-Schlüssel
  • GET/api/v1/wallet

    Ihr Wallet-Guthaben.

    Kunden-API-Schlüssel

Öffentlich (ohne Schlüssel)

  • GET/api/track/{code}

    Status, Route und Tracking-Ereignisse einer Buchung anhand ihres Tracking-Codes. Keine Finanzdaten.

    Keine
  • GET/api/custody/public/{trackingCode}

    Öffentlicher Nachweis, dass das Nachweisprotokoll einer Buchung unverändert ist (Ereignistypen, Zeiten, Hashes und Signaturen).

    Keine
  • GET/api/credentials/provider/{id}

    Der signierte Nachweis eines Anbieters (Verifizierungsstatus und Leistungsbilanz).

    Keine
  • GET/.well-known/couthacts-keys.json

    Die öffentlichen Ed25519-Schlüssel von CouthActs zum Prüfen von Signaturen.

    Keine
  • POST/api/trust/verify

    Prüft ein Nachweiszertifikat oder einen Anbieter-Nachweis.

    Keine
  • GET/api/currency/display

    Die Anzeigewährung des Nutzers und ihr Kurs zum USD (rate ist null, wenn kein aktueller Kurs vorliegt: nur USD anzeigen).

    Keine
  • GET/api/currency/supported

    Anzeigewährungen für eine Auswahl: Code, Name, Symbol und Dezimalstellen.

    Keine

Anbieter-Tracking

Standort aus Ihren Systemen melden.

Senden Sie einen Standort für eine bestätigte oder laufende Buchung. Er wird dem Kunden in Echtzeit angezeigt und als Checkpoint im signierten Nachweisprotokoll erfasst. Mit einem Layer-Namen können Sie angeben, woher ein Messwert stammt. CouthActs speichert diese Kennzeichnung, verbindet sich aber nicht selbst mit AIS-, Flug-, ELD-, Sensor- oder Satellitendaten und prüft sie nicht: Die Daten sind das, was Sie melden.

Akzeptierte Layer-Kennzeichnungen

MOBILE_GPS

Mobiles GPS

Eine GPS-Position von Smartphone oder Fahrzeug (Standard).

AIS_MARITIME

AIS (Schifffahrt)

Eine Schiffsposition aus Ihrer AIS-Quelle.

FLIGHT_TRACKING

Flugverfolgung

Eine Flugzeugposition aus Ihrer Flugverfolgungsquelle.

ELD_INTEGRATION

ELD

Eine Lkw-Position aus Ihrem elektronischen Fahrtenschreiber.

QR_PIN_CONFIRMATION

PIN-Übergabe

Eine Position bei der Übergabe. Die Liefer-PIN selbst wird in der App eingegeben.

IOT_DEVICE

IoT-Gerät

Eine Position von Ihrem Tracker. Sensorwerte werden nicht gespeichert.

SATELLITE

Satellit

Eine Position von Ihrem Satelliten-Tracker.

DOCUMENT_POD_AI

Liefernachweis

Nur eine Positionskennzeichnung. CouthActs analysiert keine Dokumente.

BIOMETRIC

Biometrie

Nur eine Positionskennzeichnung. CouthActs führt bei der Übergabe keine biometrische Prüfung durch.

Standort melden

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"
}

Authentifizierung und Sicherheit

So wird der Zugriff kontrolliert.

Bearer-Schlüssel

Jede Anfrage braucht Authorization: Bearer. Schlüssel werden in den Einstellungen erstellt, einmal angezeigt und können jederzeit widerrufen werden.

Nur HTTPS

Senden Sie Schlüssel nur über HTTPS. Betten Sie sie nie in öffentlichen Code oder clientseitige Apps ein.

Limits

Agent-Schlüssel: 120 Anfragen pro Minute. Anbieter- und Kunden-API-Schlüssel: die monatlichen Aufrufe ihres Plans, angegeben in den Headern X-RateLimit-Limit und X-RateLimit-Remaining.

Aktivitätsprotokoll

Jede Agent-Aktion wird mit Werkzeug, Status, Betrag, Eingaben und Ergebnis protokolliert und in den Einstellungen angezeigt. Anbieter-Schlüssel zeigen ihre Anfragenzahl und letzte Nutzung.

Ausgabenlimits und Freigaben

Agent-Schlüssel können ihr Limit pro Auftrag oder Monat nicht überschreiten, und Aktionen über der Freigabeschwelle warten auf die Freigabe des Kontoinhabers (Anfragen verfallen nach 72 Stunden).

Signierte Protokolle, keine signierten Anfragen

Nachweisprotokolle und Anbieter-Nachweise werden mit dem Ed25519-Schlüssel von CouthActs signiert, sodass jeder sie prüfen kann. API-Anfragen und -Antworten sind nicht signiert, und CouthActs sendet keine ausgehenden Webhooks.

Antwortformat

Konsistent. Vorhersehbar.

Antworten der Anbieter- und Kunden-API haben das unten gezeigte Format. Antworten der Agent-API enthalten stattdessen die Felder status, actionId und result; siehe die OpenAPI-Beschreibung.

Erfolg (2xx)

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

Fehler (4xx/5xx)

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

Bereit zur Integration?

Erstellen Sie einen Schlüssel in den Einstellungen und senden Sie Ihren ersten Aufruf in wenigen Minuten. Für höhere Limits oder einen Enterprise-Plan kontaktieren Sie uns.

API-Schlüssel erhalten Kontakt aufnehmen