Приложение и токен

От чьего имени говорит токен: приложение, его scopes, точки и лимиты. Первый вызов интеграции: по нему видно, что токен рабочий и каких scopes не хватает.

Загружаем поисковый индекс…

Приложение и токен

Объекты

Me

  • appobjectобязательно

    Приложение, которому принадлежит токен.

    Поля · 8
    • idintegerобязательно

      ID приложения.

    • namestringобязательно

      Название приложения, данное магазином.

    • descriptionstring или nullобязательно

      Описание приложения; null, если магазин его не написал.

    • scopesмассив stringобязательно

      Scopes приложения: что его токены могут читать и менять.

    • allowed_ipsмассив string или nullобязательно

      IP-адреса и диапазоны CIDR, с которых приложению можно обращаться; null — с любого адреса.

    • all_locationsbooleanобязательно

      true, если приложение работает со всеми точками магазина, включая добавленные позже.

    • location_idsмассив integer или nullобязательно

      Точки, с которыми работает приложение, когда all_locations — false; null, если со всеми.

    • created_atstring (date-time)обязательно

      Когда приложение создано.

  • tokenobjectобязательно

    Токен этого запроса.

    Поля · 3
    • namestringобязательно

      Название токена, данное при выпуске.

    • prefixstringобязательно

      Видимый префикс токена: различает токены, не раскрывая их.

    • expires_atstring (date-time) или nullобязательно

      Когда истекает срок токена; null, если срока нет.

  • store_idintegerобязательно

    ID магазина, которому принадлежит токен.

  • rate_limitsobjectобязательно

    Лимиты запросов приложения.

    Поля · 2
    • appobjectобязательно

      Корзина приложения, общая для всех его токенов.

      Поля · 2
      • per_minuteintegerобязательно

        Сколько запросов в минуту восполняет корзина.

      • burstintegerобязательно

        Сколько запросов можно отправить подряд, прежде чем вступит поминутный темп.

    • storeobjectобязательно

      Корзина магазина, общая для всех его приложений.

      Поля · 2
      • per_minuteintegerобязательно

        Сколько запросов в минуту восполняет корзина.

      • burstintegerобязательно

        Сколько запросов можно отправить подряд, прежде чем вступит поминутный темп.

Методы

Приложение токена, его доступ и лимиты

get/me

Scope: любой токен магазина

Ответы

200Успешно

application/json

Возвращает Me

401Токена нет, он неверен, истёк или отозван

Заголовки

  • WWW-Authenticatestringобязательно

    Схема аутентификации (RFC 6750).

    Пример:
    Bearer

application/problem+json

Возвращает Problem

403Запрос не разрешают тариф, IP-адрес или scopes токена

Заголовки

  • WWW-Authenticatestring

    Схема аутентификации (RFC 6750).

    Пример:
    Bearer error="insufficient_scope", scope="locations:read"

application/problem+json

Возвращает ForbiddenProblem

422Параметр неверен или неизвестен

application/problem+json

Возвращает ValidationProblem

429Лимит запросов исчерпан

Заголовки

  • Retry-Afterintegerобязательно

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает RateLimitProblem

503Магазин временно недоступен

Заголовки

  • Retry-Afterinteger

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает Problem

Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки

Пример запроса
curl "https://api.saleya.app/v1/me" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Пример ответа · 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
    }
  }
}