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.

Cargando el índice de búsqueda…

Aplicación y token

Objetos

Me

  • appobjectobligatorio

    La aplicación a la que pertenece el token.

    Campos · 8
    • idintegerobligatorio

      ID de la aplicación.

    • namestringobligatorio

      Nombre de la aplicación que le dio la tienda.

    • descriptionstring o nullobligatorio

      Descripción de la aplicación; null si la tienda no la escribió.

    • scopesarray de stringobligatorio

      Scopes otorgados a la aplicación: qué pueden leer y cambiar sus tokens.

    • allowed_ipsarray de string o nullobligatorio

      Direcciones IP y rangos CIDR desde los que la aplicación puede llamar; null significa cualquier dirección.

    • all_locationsbooleanobligatorio

      true si la aplicación trabaja con todos los locales de la tienda, incluidos los que se agreguen después.

    • location_idsarray de integer o nullobligatorio

      Locales con los que trabaja la aplicación cuando all_locations es false; null si trabaja con todos.

    • created_atstring (date-time)obligatorio

      Cuándo se creó la aplicación.

  • tokenobjectobligatorio

    El token de esta solicitud.

    Campos · 3
    • namestringobligatorio

      Nombre del token dado al emitirlo.

    • prefixstringobligatorio

      Prefijo visible del token: distingue los tokens sin revelarlos.

    • expires_atstring (date-time) o nullobligatorio

      Cuándo vence el token; null si no vence.

  • store_idintegerobligatorio

    ID de la tienda a la que pertenece el token.

  • rate_limitsobjectobligatorio

    Límites de solicitudes de la aplicación.

    Campos · 2
    • appobjectobligatorio

      Balde de la aplicación, compartido por todos sus tokens.

      Campos · 2
      • per_minuteintegerobligatorio

        Solicitudes por minuto con las que se recarga el balde.

      • burstintegerobligatorio

        Solicitudes que se pueden enviar seguidas antes de que rija el ritmo por minuto.

    • storeobjectobligatorio

      Balde de la tienda, compartido por todas sus aplicaciones.

      Campos · 2
      • per_minuteintegerobligatorio

        Solicitudes por minuto con las que se recarga el balde.

      • burstintegerobligatorio

        Solicitudes 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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
curl "https://api.saleya.app/v1/me" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ejemplo de respuesta · 200
{
  "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
    }
  }
}