Plataforma para desarrolladores

Desarrolla sobre
CouthActs.

Una API para agentes y un servidor MCP para asistentes de IA, una API para proveedores para sistemas de despacho y telemática, y endpoints públicos para verificar registros de custodia firmados. JSON sencillo sobre HTTPS con claves bearer.

Obtener claves de API Hablar con nosotros

Claves y límites

Elige tu clave.

Claves de agente

Sin cuota de plan

Para agentes y asistentes de IA que actúan en nombre de una cuenta de cliente.

Permisos que tú eliges: cotizar, trabajos, reservas, billetera y confianza
Límites de gasto por trabajo y mensuales, más un umbral de aprobación
Hasta 120 solicitudes por minuto por clave
Créalas en Configuración → Agentes de IA, o conecta un asistente con OAuth

Crear una clave de agente

API para proveedores

Plan Basic

Para proveedores que conectan sus propios sistemas de despacho o telemática.

Basic: 500 llamadas al mes; después se rechazan
Trabajos abiertos, tus reservas, tu billetera y actualizaciones de ubicación
Professional (5,000 llamadas al mes) y Enterprise: próximamente
Crea las claves en Configuración → Claves de API de proveedor

Gestionar claves de proveedor

API para clientes

Bajo acuerdo

Endpoints REST para los trabajos, ofertas y billetera de un cliente.

Starter: 1,000 llamadas al mes; después se rechazan
Growth: 5,000 llamadas al mes y luego US$0.20 por llamada, cobrados a tu Billetera al mes siguiente
Enterprise: límites según lo acordado
Las claves aún no son de autoservicio; la mayoría de los clientes debería usar una clave de agente

Contáctanos

Los planes de pago de la API para proveedores (Professional y Enterprise) llegarán pronto; contáctanos si necesitas límites más altos ahora. Tu plan actual y tu uso se muestran en Configuración. Las API se ofrecen sin compromiso de nivel de servicio.

Inicio rápido

Tres pasos para tu primera llamada.

Paso 01

Obtén tu clave

Clientes y agentes de IA: Configuración → Agentes de IA. Proveedores: Configuración → Claves de API de proveedor. La clave completa se muestra una sola vez, al crearla.

Paso 02

Haz tu primera solicitud

Envía tu clave en Authorization: Bearer. Los proveedores pueden empezar con GET /api/provider/v1/jobs.

Paso 03

Explora las herramientas para agentes

Claves de agente: consulta la descripción OpenAPI en /api/agent/openapi.json o conecta un cliente MCP a /api/mcp.

Solicitud de ejemplo

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

Referencia completa.

Todos los importes de las respuestas de la API, de los agentes y de MCP están en USD (campos que terminan en Usd): CouthActs cobra y paga solo en USD. Para mostrar un equivalente local, llama a GET /api/currency/display una vez por pantalla y multiplica: local ≈ amountUsd × rate. Muestra primero la cifra en USD y la local como estimación.

API para agentes y MCP

GET/api/agent/v1/tools
Lista las acciones que puede realizar tu clave de agente, con sus esquemas de entrada.
Clave de agente
POST/api/agent/v1/tools/{name}
Ejecuta una acción (por ejemplo, get_quote o post_job) dentro de los permisos, límites de gasto y reglas de aprobación de tu clave.
Clave de agente
GET/api/agent/openapi.json
Descripción OpenAPI 3.1 de las herramientas para agentes.
Ninguna
POST/api/mcp
Las mismas acciones mediante el Model Context Protocol, para Claude, ChatGPT y otros asistentes compatibles con MCP.
Clave de agente / OAuth

API para proveedores

GET/api/provider/v1/jobs
Trabajos abiertos en tus modalidades de transporte registradas (filtrables por modalidad; paginados).
Clave de API de proveedor
GET/api/provider/v1/bookings
Tus reservas con estado, código de seguimiento y estado de la retención del pago.
Clave de API de proveedor
POST/api/provider/v1/tracking
Informa una ubicación de una reserva activa; se muestra al cliente y queda registrada en el Registro de custodia.
Clave de API de proveedor
GET/api/provider/v1/wallet
El saldo de tu billetera y tus transacciones recientes.
Clave de API de proveedor

API para clientes

GET · POST/api/v1/jobs
Lista tus trabajos o publica uno (cobra las tarifas y retiene el presupuesto de tu Billetera).
Clave de API de cliente
GET · PATCH/api/v1/jobs/{id}
Consulta un trabajo, actualiza su presupuesto o descripción, o cancélalo.
Clave de API de cliente
GET · POST/api/v1/bids
Lista las ofertas de tus trabajos, o acepta o rechaza una oferta.
Clave de API de cliente
GET/api/v1/wallet
El saldo de tu billetera.
Clave de API de cliente

Públicos (sin clave)

GET/api/track/{code}
Estado, ruta y eventos de seguimiento de una reserva por su código de seguimiento. Sin datos financieros.
Ninguna
GET/api/custody/public/{trackingCode}
Prueba pública de que el Registro de custodia de una reserva está intacto (tipos de evento, horas, hashes y firmas).
Ninguna
GET/api/credentials/provider/{id}
La credencial firmada de un proveedor (estado de verificación e historial).
Ninguna
GET/.well-known/couthacts-keys.json
Las claves públicas Ed25519 de CouthActs para comprobar firmas.
Ninguna
POST/api/trust/verify
Comprueba un certificado de custodia o una credencial de proveedor.
Ninguna
GET/api/currency/display
La moneda de visualización del usuario y su tipo frente al USD (rate es null si no hay tipo en vivo: muestra solo USD).
Ninguna
GET/api/currency/supported
Monedas de visualización para un selector: código, nombre, símbolo y decimales.
Ninguna

Seguimiento del proveedor

Informa la ubicación desde tus sistemas.

Envía una ubicación de una reserva confirmada o en curso. Se muestra al cliente en tiempo real y queda registrada como punto de control en el Registro de custodia firmado. Puedes etiquetar el origen de cada lectura con un nombre de capa. CouthActs guarda la etiqueta, pero no se conecta ni comprueba por sí mismo fuentes AIS, de vuelos, ELD, de sensores ni satelitales: los datos son los que tú informas.

Etiquetas de capa aceptadas

MOBILE_GPS

GPS móvil

Una posición GPS de un teléfono o del vehículo (la predeterminada).

AIS_MARITIME

AIS (marítimo)

La posición de un buque desde tu fuente AIS.

FLIGHT_TRACKING

Seguimiento de vuelos

La posición de una aeronave desde tu fuente de seguimiento de vuelos.

ELD_INTEGRATION

ELD

La posición de un camión desde tu dispositivo de registro electrónico.

QR_PIN_CONFIRMATION

Entrega con PIN

Una posición en el momento de la entrega. El PIN de entrega se introduce en la app.

IOT_DEVICE

Dispositivo IoT

Una posición desde tu rastreador. Las lecturas de sensores no se guardan.

SATELLITE

Satélite

Una posición desde tu rastreador satelital.

DOCUMENT_POD_AI

Prueba de entrega

Solo una etiqueta de posición. CouthActs no analiza documentos.

BIOMETRIC

Biométrico

Solo una etiqueta de posición. CouthActs no realiza comprobaciones biométricas en la entrega.

Informar una ubicación

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

Autenticación y seguridad

Cómo se controla el acceso.

Claves bearer

Cada solicitud necesita Authorization: Bearer. Las claves se crean en Configuración, se muestran una vez y se pueden revocar en cualquier momento.

Solo HTTPS

Envía las claves solo por HTTPS. Nunca las incluyas en código público ni en apps del lado del cliente.

Límites

Claves de agente: 120 solicitudes por minuto. Claves de API de proveedor y de cliente: las llamadas mensuales de su plan, indicadas en las cabeceras X-RateLimit-Limit y X-RateLimit-Remaining.

Registro de actividad

Cada acción de un agente se registra con su herramienta, estado, importe, entradas y resultado, y se muestra en Configuración. Las claves de proveedor muestran su número de solicitudes y su último uso.

Límites de gasto y aprobaciones

Las claves de agente no pueden superar su límite por trabajo ni el mensual, y las acciones por encima del umbral de aprobación esperan la aprobación del titular (las solicitudes vencen a las 72 horas).

Registros firmados, no solicitudes firmadas

Los Registros de custodia y las credenciales de proveedor se firman con la clave Ed25519 de CouthActs, para que cualquiera pueda comprobarlos. Las solicitudes y respuestas de la API no se firman, y CouthActs no envía webhooks salientes.

Formato de respuesta

Coherente. Predecible.

Las respuestas de las API para proveedores y para clientes usan el formato siguiente. Las respuestas de la API para agentes tienen en su lugar los campos status, actionId y result; consulta la descripción OpenAPI.

Éxito (2xx)

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

Error (4xx/5xx)

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

Bienvenidos, desarrolladores

¿Listo para integrar?

Crea una clave en Configuración y haz tu primera llamada en minutos. Para límites más altos o un plan Enterprise, contáctanos.

Obtener claves de API Hablar con nosotros

Desarrolla sobreCouthActs.

Elige tu clave.

Claves de agente

API para proveedores

API para clientes

Tres pasos para tu primera llamada.

Obtén tu clave

Haz tu primera solicitud

Explora las herramientas para agentes

Referencia completa.

API para agentes y MCP

API para proveedores

API para clientes

Públicos (sin clave)

Informa la ubicación desde tus sistemas.

Etiquetas de capa aceptadas

GPS móvil

AIS (marítimo)

Seguimiento de vuelos

ELD

Entrega con PIN

Dispositivo IoT

Satélite

Prueba de entrega

Biométrico

Cómo se controla el acceso.

Claves bearer

Solo HTTPS

Límites

Registro de actividad

Límites de gasto y aprobaciones

Registros firmados, no solicitudes firmadas

Coherente. Predecible.

¿Listo para integrar?

Desarrolla sobre
CouthActs.