Autenticación
Autentica cada solicitud con un token Bearer de tu organización.
La autenticación se hace solo con el encabezado Authorization. No se aceptan cookies, y el token no se puede enviar en la URL (como parámetro de consulta). Todos los endpoints piden el mismo encabezado.
Authorization: Bearer pxn_live_…Bearer seguido del token. Las solicitudes sin token o con un formato incorrecto reciben 401 unauthorized.
Por qué solo el encabezado
Las URL acaban en los logs del servidor y en el encabezado Referer; un token que viaja en la URL se filtra por ahí. Al no aceptar cookies, además, desaparece por completo la superficie de falsificación de solicitudes entre sitios (CSRF).
URL base
https://api.proxynet.io/api/v1Primera solicitud
curl -H "Authorization: Bearer pxn_live_…" \
https://api.proxynet.io/api/v1/meLa respuesta incluye el nombre del token, sus permisos y la organización a la que está vinculado. Una solicitud a un endpoint para el que el token no tiene permiso devuelve403 insufficient_scope; qué permiso habilita qué endpoints se explica en la página Tokens y permisos.
Mantén el token seguro
- Guarda el token en una variable de entorno o en un gestor de secretos.
- Da un token distinto a cada integración; si uno se filtra, solo revocas ese.
- Elige solo los permisos necesarios. Un servidor de seguimiento no necesita el permiso
orders:write. - La creación y la revocación de tokens quedan registradas en la página Actividad de la organización.
Preguntas frecuentes
¿Puedo enviar el token en la URL?
No. No se acepta un parámetro de consulta como ?token=; solo se lee el encabezado Authorization.
¿Puedo llamarla desde el navegador?
No. La API no da permiso CORS a las llamadas que llegan desde el navegador. El panel ¡Pruébalo! de esta documentación envía las solicitudes a través de nuestro propio proxy; en tu propio frontend, haz la solicitud desde tu servidor.
¿Un token puede acceder a varias organizaciones?
No. El token pertenece a la organización en la que se creó. Para los servicios de otra organización, crea un token aparte en esa organización.