Autenticación

Cada punto final en la API de Genesis espera un token en el auth-token encabezado de solicitud. Una solicitud sin él responde 401.

Obtención de un token

Intercambie una credencial API por un token con POST /proxy/apiToken. La credencial se emite por Proveedor de servicio, por lo que la solicitud indica el proveedor para el cual debe actuar el token.

{
  "serviceProviderId": "string (required)",
  "accessId": "string (required)",
  "clientSecret": "string (required)"
}

La credencial accessId and clientSecret se emiten en la plataforma Genesis bajo la configuración del Proveedor de servicio. Mantenga el secreto en su servidor: un token puede enviarse a un navegador, la credencial que lo genera no debe hacerlo.

Uso del token

curl -H "auth-token: <token>" https://api.nxgen.cloud/api/v1/user/me

GET /user/me devuelve la cuenta a la que pertenece el token, lo que lo convierte en la verificación más rápida de que un token funciona.

Probando solicitudes desde la documentación

La referencia interactiva en /api-reference es la misma especificación en Swagger UI, y la descripción general enumera cada recurso. Pulse Authorize, pegue un token, y cada Pruébelo panel lo envía como auth-token. El token permanece en su navegador; las solicitudes van directamente desde él a https://api.nxgen.cloud/api/v1.