Organización
Tokens y permisos
Da a cada token solo los permisos que necesita; un endpoint sin permiso devuelve 403.
Al crear un token eliges uno o más permisos. Los permisos de lectura, por sí solos, no pueden tocar tu saldo: las operaciones con cargo requieren un permiso aparte (orders:write), y los cambios de configuración, otro (proxies:write).
Permisos
| Permiso | Nombre | Descripción |
|---|---|---|
orders:read | Información de servicios | Días restantes, tráfico usado, número de solicitudes y de errores; catálogo, stock y cotización. |
proxies:read | Lista de proxies | Direcciones de proxy y datos de acceso. Incluye credenciales; concédelo con cuidado. |
logs:read | Logs | Logs de solicitudes. Requiere además que tu plan incluya acceso a logs. |
orders:write | Creación de pedidos | Abre pedidos de proxy nuevos y COBRA DE TU SALDO. Concédelo solo a la integración que de verdad vaya a hacer compras. |
proxies:write | Configuración de proxies | Cambia la configuración de los servicios existentes, como el nombre del servicio y el límite de tráfico. No genera cargos. |
Qué endpoints habilita cada permiso
orders:read
- GET
/meInformación del token y de la organización - GET
/catalogCatálogo - GET
/locationsUbicaciones - GET
/target-urlsDominios de destino - GET
/stockComprobación de stock - GET
/pricingCotización - GET
/ordersListar servicios - GET
/orders/{id}Detalles del servicio - GET
/orders/{id}/usage-historyHistorial de uso
proxies:read
- GET
/orders/{id}/accessListas de acceso - GET
/orders/{id}/connectionDatos de acceso - GET
/orders/{id}/proxiesLista de proxies
logs:read
orders:write
- POST
/ordersCrear pedido - POST
/orders/{id}/renewRenovar servicio - PUT
/orders/{id}/auto-renewRenovación automática
proxies:write
Conjuntos de permisos recomendados
| Integración | Permisos |
|---|---|
| Seguimiento del uso y de los plazos | orders:read |
| Entrega de la lista de proxies al cliente | orders:read, proxies:read |
| Análisis de logs | orders:read, logs:read |
| Compra y renovación automáticas | orders:read, orders:write, proxies:read |
| Automatización del nombre y del límite de tráfico | orders:read, proxies:write |
Cuando el nombre de usuario y la contraseña se generan automáticamente en el pedido, el token también necesita proxies:read para que se devuelvan en la respuesta.