Приложение и токен
От чьего имени говорит токен: приложение, его 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"{
"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
}
}
}