Autenticación

Métodos disponibles#

Qué acepta cada serie#

Los dos métodos no son intercambiables en toda la API. Una API key identifica a la integración; un token identifica además al usuario y a su empresa. Los endpoints que necesitan saber quién hizo la acción —para resolver la empresa, para dejar traza, o para escribir un historial— sólo aceptan el token.

Si mandas x-api-key a un endpoint que sólo acepta token, la respuesta es 401.

Los ejemplos de cada página usan el método que ese endpoint sí acepta. Cuando tengas duda, Authorization: Bearer funciona en toda la API.

Obtener credenciales#

Solicita tus credenciales a tu contacto en Nexcar o a soporte@nexcar.mx. Recibirás una api_key para producción y otra para el ambiente de sandbox.

Nunca expongas tu api_key en clientes web ni la subas a un repositorio público.

Ejemplo: subir un documento con API Key#

curl -X POST https://api.nexcar.mx/v1/documents \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "case_id": "11111111-2222-3333-4444-555555555555",
    "url": "https://tu-storage.example.com/factura-vehiculo.pdf",
    "mime_type": "application/pdf",
    "type": "factura"
  }'

Ejemplo: crear caso con Bearer Token#

curl -X POST https://api.nexcar.mx/v1/cases \
  -H "Authorization: Bearer tu_token_jwt" \
  -H "Content-Type: application/json" \
  -d '{
    "internal_id": "EXP-2026-0001",
    "vehicle_origin": "Nacional",
    "status": "processing"
  }'

Errores de autenticación#