v1 · vista previa

Prueba con webhook firma, alert.created, location_withheld o 429.

↑ ↓ moverseIntro abrirEsc cerrar

Referencia

Autenticación

OAuth2 client_credentials: un token opaco de una hora.

Pedir un token (client_credentials)

POST/v1/oauth/token

Sin token: se autentica con el client_secret.

OAuth2 client_credentials. El token es opaco, dura una hora y se revoca al instante al dar de baja al cliente.

Cuerpo application/x-www-form-urlencoded TokenRequest

  • grant_typestringobligatorio

    Valores posibles: client_credentials

  • client_idstringobligatorio
  • client_secretstringobligatorio
  • scopestring

    Separados por espacios; subconjunto de los del cliente. Sin él, todos los del cliente.

Respuestas

  • 200

    Token emitido.

    application/json TokenResponse

  • 400

    Petición mal formada o scope no permitido.

    application/json OAuthError

  • 401

    Cliente o secreto incorrectos.

    application/json OAuthError

Petición · sandbox

curl -X POST https://sandbox.api.safeonuba.com/v1/oauth/token \
  -d grant_type=client_credentials \
  -d client_id="$SAFEONUBA_CLIENT_ID" \
  -d client_secret="$SAFEONUBA_CLIENT_SECRET" \
  -d scope="alerts:read musters:read"

Respuesta 200

JSON
{
  "access_token": "at_9c1e…",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "alerts:read alerts:write musters:read"
}