---
title: "Autenticación"
source: /es/gcxone/api/authentication
locale: es
updated: 2026-09-04
---
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.

```json
{
  "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

```bash
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](/api-reference) es la misma especificación en Swagger UI, y [la descripción general](/gcxone/api/overview) 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`.