Entrar

Conceder scopes al acceso

POST https://{organization}.myguper.com/api/connect/accessScope

Anexa uno o más scopes a un apiKey existente. Un scope es el par service.scope declarado por cada servicio Guper en la configuración de la cuenta.

Hoy cada servicio expone un único scope all — register.all, loyalty.all, order.all, sender.all, catalog.all, organization.all, journey.all, media-manager.all, auditObserver.all, pipeline.all, gapp-be.all — y connect expone seis más finos: connect.user, connect.access, connect.scope, connect.session, connect.auth y connect.mcp. Los scopes más finos de los demás servicios se van creando conforme aparece la necesidad.

Una petición cuyo token pertenece a una llave sin el scope que la ruta exige se rechaza con 403, y la respuesta nombra el scope que falta en requiredScope. Las llamadas firmadas entre servicios Guper no pasan por esa verificación.

Scopes enviados que no coinciden con un service.scope conocido vuelven en invalidScopes; las concesiones duplicadas se ignoran silenciosamente. La respuesta siempre refleja lo que efectivamente se persistió.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

Most Connect endpoints require a valid x-guper-authorization token. Token issuance itself (/api/connect/auth) is the exception — it uses the x-guper-apikey and x-guper-apisecret credentials.

Encabezados

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Cuerpo de la petición

Content-Type: application/json

{
    "apiKey": "acme",
    "scope": "[\"register.all\", \"loyalty.all\", \"connect.user\"]"
}

Respuestas

{
    "organization": "acme",
    "access":       "acme",
    "scopes": [
        { "scope": 1, "access": 11 },
        { "scope": 2, "access": 11 }
    ],
    "dateTime":     "2026-05-04T13:38:53-03:00"
}

Relacionados

Copied to clipboard