Aplicación y token
En nombre de quién habla el token: la aplicación, sus scopes, locales y límites. La primera llamada: muestra si el token funciona y qué scopes faltan.
Aplicación y token
Objetos
Me
appobjectobligatorioLa aplicación a la que pertenece el token.
Campos · 8
idintegerobligatorioID de la aplicación.
namestringobligatorioNombre de la aplicación que le dio la tienda.
descriptionstring o nullobligatorioDescripción de la aplicación; null si la tienda no la escribió.
scopesarray de stringobligatorioScopes otorgados a la aplicación: qué pueden leer y cambiar sus tokens.
allowed_ipsarray de string o nullobligatorioDirecciones IP y rangos CIDR desde los que la aplicación puede llamar; null significa cualquier dirección.
all_locationsbooleanobligatoriotrue si la aplicación trabaja con todos los locales de la tienda, incluidos los que se agreguen después.
location_idsarray de integer o nullobligatorioLocales con los que trabaja la aplicación cuando all_locations es false; null si trabaja con todos.
created_atstring (date-time)obligatorioCuándo se creó la aplicación.
tokenobjectobligatorioEl token de esta solicitud.
Campos · 3
namestringobligatorioNombre del token dado al emitirlo.
prefixstringobligatorioPrefijo visible del token: distingue los tokens sin revelarlos.
expires_atstring (date-time) o nullobligatorioCuándo vence el token; null si no vence.
store_idintegerobligatorioID de la tienda a la que pertenece el token.
rate_limitsobjectobligatorioLímites de solicitudes de la aplicación.
Campos · 2
appobjectobligatorioBalde de la aplicación, compartido por todos sus tokens.
Campos · 2
per_minuteintegerobligatorioSolicitudes por minuto con las que se recarga el balde.
burstintegerobligatorioSolicitudes que se pueden enviar seguidas antes de que rija el ritmo por minuto.
storeobjectobligatorioBalde de la tienda, compartido por todas sus aplicaciones.
Campos · 2
per_minuteintegerobligatorioSolicitudes por minuto con las que se recarga el balde.
burstintegerobligatorioSolicitudes que se pueden enviar seguidas antes de que rija el ritmo por minuto.
Endpoints
Obtener la aplicación del token, su acceso y sus límites
get/me
Scope: cualquier token de la tienda
Respuestas
200Éxito
application/json
Devuelve Me
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl "https://api.saleya.app/v1/me" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"app": {
"id": 0,
"name": "string",
"description": "string",
"scopes": [
"string"
],
"allowed_ips": [
"string"
],
"all_locations": true,
"location_ids": [
0
],
"created_at": "2026-01-15T12:00:00Z"
},
"token": {
"name": "string",
"prefix": "string",
"expires_at": "2026-01-15T12:00:00Z"
},
"store_id": 0,
"rate_limits": {
"app": {
"per_minute": 0,
"burst": 0
},
"store": {
"per_minute": 0,
"burst": 0
}
}
}