Descripción general e inicio rápido

Elija REST o MCP

Ambas interfaces utilizan el mismo motor de cálculo y el mismo modelo de permisos. Utilice REST con una clave API para aplicaciones y scripts donde controle cada solicitud. Utilice MCP cuando un asistente o agente de IA deba descubrir las herramientas disponibles, comprender sus esquemas y elegir el cálculo correcto por sí mismo.

Autenticación

Dos métodos de inicio de sesión llegan al mismo motor de cálculo. Los clientes de IA interactivos se conectan al servidor MCP y autorizan el acceso en el navegador con OAuth. Las aplicaciones, servicios, scripts e integraciones manuales usan una clave Road User Tools API enviada como token Bearer. Las claves se pueden crear de forma gratuita y se pueden rotar o revocar en cualquier momento.

Authorization: Bearer rut_live_...

Inicio rápido sobre REST

Envíe una solicitud JSON a cualquier terminal REST versionado utilizando su clave API. Las respuestas utilizan un consistenteok, data, yerrorestructura en todas las herramientas de cálculo.

curl -X POST https://roaduser.tools/api/v1/journey-time \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "distance": { "value": 250, "unit": "km" },
    "speed": { "value": 100, "unit": "kmh" }
  }'

Inicio rápido sobre MCP

Añada la URL del servidor a un cliente de IA compatible y apruebe el acceso en su navegador cuando se abra la página de autorización de Road User Tools. El cliente descubre automáticamente la configuración de inicio de sesión y las herramientas disponibles, sin claves ni tokens que copiar.

https://roaduser.tools/mcp

Alternativa: configuración manual con una clave API

Los clientes sin autorización en el navegador y las integraciones programáticas pueden enviar una clave API en su lugar:

{
  "mcpServers": {
    "roaduser-tools": {
      "url": "https://roaduser.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Formato de respuesta REST

Las respuestas exitosas REST devuelven el resultado calculado endata. Los errores de validación y solicitud devuelven un código de error estable legible por máquina junto con un mensaje legible por humanos.

{
  "ok": true,
  "data": {
    "totalHours": 2.5,
    "formatted": "2:30:00"
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Invalid journey time input."
  }
}