Organización y miembros
Los servicios, el saldo, el plan y los tokens de API pertenecen a una organización; los miembros autorizados operan en nombre de esa organización.
El panel de Proxynet funciona con el modelo de organizaciones de GitHub. Una organización reúne los servicios, el saldo, el plan y los tokens. Los miembros autorizados de la organización crean y gestionan proxies en el panel; la API hace lo mismo mediante un token.
Qué pertenece a la organización
Servicios
GET /orders lista los servicios de la organización.Saldo y plan
Tokens de API
Actividad
A qué organización está vinculado el token
En la respuesta de GET /me, el campo organization indica la organización a la que está vinculado el token, y el campo access, qué puede ver este token dentro de la organización.
{
"data": {
"token": { "name": "Servidor de monitorización", "scopes": ["orders:read"] },
"organization": { "id": "…", "name": "Stax", "slug": "stax" },
"access": { "order_visibility": "all", "logs": true },
"plan": { "name": "Tier 2", "custom_credentials": true },
"billing": { "balance": 124.5, "currency": "USD" }
}
}access.order_visibility: qué servicios de la organización puede ver el token. Los endpoints de lista y de detalle aplican la misma visibilidad que el panel.access.logs: si los endpoints de logs están habilitados para este token. El acceso a los logs requiere además que el plan incluya acceso a logs.
Plan y precio
El plan se define a nivel de organización. /me, /catalog y /pricing usan la misma fuente de plan, por lo que una cotización y el cargo que se aplica al hacer el pedido coinciden. En una organización sin plan asignado se usa el plan más bajo, y en las respuestas aparece price_source: base_plan.
plan.custom_credentials indica si puedes elegir tú mismo el nombre de usuario y la contraseña en el pedido. Si no está permitido, una solicitud que envíe esos campos devuelve403 tier_required; si no los envías, los valores se generan automáticamente.
Varias organizaciones
Un usuario puede ser miembro de varias organizaciones; un token, en cambio, pertenece a una sola organización. Crea un token aparte para cada organización y, en tu integración, determina la organización eligiendo el token.