Saltar al contenido

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

Todos los pedidos de proxy se abren a nombre de la organización. GET /orders lista los servicios de la organización.

Saldo y plan

Los pedidos se pagan con el saldo de la organización; los precios salen del plan (tier) de la organización.

Tokens de API

Un token se crea en una organización y solo ve los servicios de esa organización.

Actividad

Cada cambio hecho con la API se registra en la página Actividad de la organización.

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.

GET /me (abreviado)
{
  "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.