Autenticación

Todas las llamadas a la API de Punto requieren una clave de acceso (API key). Sin ella, la API rechazará la petición con un error 401 Unauthorized.

Cómo obtener tu clave

Las claves se asignan por cuenta de cliente. Escríbenos a support@punto.ai y te facilitamos tus credenciales de sandbox y producción.

Cómo incluirla en tus peticiones

Añade la clave como un token Bearer en la cabecera Authorization:

http

Authorization: Bearer YOUR_API_KEY

Ejemplo con curl:

bash

curl https://api.punto.ai/v1/customer/shipping-addresses \
  -H "Authorization: Bearer YOUR_API_KEY"

Entornos

Disponemos de dos entornos con URLs base distintas:

Entorno	URL base
Desarrollo	`https://api.dev.punto.ai`
Producción	`https://api.punto.ai`

Usa el entorno de desarrollo mientras integras. Funciona exactamente igual que producción pero no envía peticiones reales a la DGT, por lo que puedes probar con total libertad.

Error de autenticación

Si la clave falta o no es válida, recibirás:

json

{
  "statusCode": 401,
  "message": "Unauthorized"
}

Buenas prácticas

No incluyas tu clave en código cliente (frontend) ni en repositorios públicos.
Si crees que una clave se ha visto comprometida, contáctanos en support@punto.ai para rotarla.
Cada clave está vinculada a una única cuenta de cliente.

Siguientes pasos

Trámites — automatiza matriculaciones y transferencias con la DGT
Referencia API — documentación completa de todos los endpoints