Toda la documentación

API de cuenta e integraciones

Clave de cuenta y token de integración

La clave de cuenta con nombre usa Authorization: Bearer para los servicios de cuenta del panel. GET /panel-api/account valida la vinculación. GET /panel-api/server-key permanece como validación de compatibilidad; no crea ni monitoriza servidores. El intercambio email/apiToken en /v1/api/auth/token es un flujo de integración distinto del inicio de sesión SSH.

GET /panel-api/account
Authorization: Bearer <ACCOUNT_API_KEY>

POST /v1/api/auth/token
Content-Type: application/json
{"email":"user@example.com","apiToken":"<INTEGRATION_API_TOKEN>"}

GET /v1/api/tokens
Authorization: Bearer <INTEGRATION_ACCESS_TOKEN>

Recursos disponibles para integraciones

La API /v1/api ofrece autenticación, consultas de wallet, saldo y movimientos de tokens, paquetes, checkout y verificación IAP. Cada petición autenticada debe utilizar la credencial que exige esa API. Ya no incluye CRUD de inventario de servidores, llaves SSH, categorías o etiquetas. Las operaciones de pago modifican estado financiero: no las uses para probar conectividad.

  • GET /v1/api/wallet
  • GET /v1/api/wallet/ledger
  • GET /v1/api/tokens
  • GET /v1/api/tokens/ledger
  • GET /v1/api/tokens/packs
  • POST /v1/api/tokens/checkout
  • POST /v1/api/tokens/iap/verify

Seguridad y errores

No envíes claves de cuenta a URL de paneles desconocidos ni a terceros. Ante un 401 comprueba credenciales; ante un 403, permisos; ante un 429, espera antes de reintentar. Revisa el cuerpo del error y evita reintentar automáticamente pagos no idempotentes. Administrar claves requiere sesión del portal y sus comprobaciones de seguridad.