Centro de ayudaGitHub

Autenticación

La API de atoship usa claves de API para autenticar las solicitudes. Puedes ver y administrar tus claves de API en el Panel.

Claves de API

Tus claves de API otorgan numerosos privilegios, así que asegúrate de mantenerlas seguras. No compartas tus claves de API secretas en lugares de acceso público como GitHub, código del lado del cliente, etc.

Producción
ak_live_...

Usa las claves de producción cuando estés listo para generar etiquetas de envío reales.

Prueba
ak_test_...

Usa las claves de prueba para desarrollo y pruebas. No se generará ninguna etiqueta real.

Autenticar solicitudes

La autenticación se realiza mediante el encabezado Authorizationusando autenticación con token Bearer.

Authorization: Bearer ak_live_abc123...

Buenas prácticas de seguridad

Usa variables de entorno

Guarda las claves de API en variables de entorno, no en el código

Rota las claves con regularidad

Genera nuevas claves periódicamente y revoca las antiguas

Usa claves de prueba para desarrollo

Nunca uses claves de producción en entornos de desarrollo o pruebas

Restringe los permisos de las claves

Crea claves separadas con permisos limitados para cada servicio

Errores de autenticación

401
No autorizado

No se proporcionó una clave de API válida o la clave fue revocada

403
Prohibido

La clave de API no tiene permisos para el recurso solicitado

GET
Solicitud autenticada
1"text-emerald-400">curl https://atoship.com/api/v1/account "text-emerald-400">\
2 "text-blue-400">-H "Authorization: Bearer ak_live_abc123..."
Encabezados obligatorios
Authorization:Bearer ak_live_...
Content-Type:application/json
Prefijos de clave
ak_live_Clave secreta de producción
ak_test_Clave secreta de prueba
pk_live_Clave publicable de producción
pk_test_Clave publicable de prueba
atoship © 2026