Преминете към съдържанието
ShopentlyLearn

Схеми на данните: Удостоверяване

Схеми на данните: Удостоверяване. Полета, типове и ограничения на данните, приемани или връщани от API.

Схеми на данните

Получаване · Токен — Удостоверяване — Отговор

ApiResponse_TokenData_ · Полета, типове и ограничения на данните, приемани или връщани от API.
dataTokenData Задължително

Примерен отговор · TokenData.

Пример: {"access_token":"EXAMPLE_ACCESS_TOKEN","expires_at":"2026-01-01T12:00:00Z","expires_in":900,"rate_limits":{"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10},"token_type":"Bearer"}
metaContextPageMeta ContextMeta PageMeta RequestMeta Задължително

Метаданни на отговора.

Пример: {"request_id":"example"}

Допълнителни полета: Не

Получаване · Токен — Удостоверяване — Отговор

TokenData · Полета, типове и ограничения на данните, приемани или връщани от API.
access_tokenНизЗадължително

Токен за заглавката Authorization: Bearer. Задайте SHOPENTLY_ACCESS_TOKEN преди изпълнение на отделния пример.

Пример: "EXAMPLE_ACCESS_TOKEN"
expires_atНизЗадължително

Момент на изтичане в UTC. Текущите ограничения за достъп могат да блокират токена по-рано.

format: "date-time"
Пример: "2026-01-01T12:00:00Z"
expires_inЦяло числоНезадължително

900 секунди, тоест 15 минути от издаването. Изпращането на заявки не удължава валидността.

По подразбиране: 900Пример: 900
rate_limitsTokenRateLimitsData Задължително

Engine ≥ 4.143.0. Всеки отговор с токен съдържа data.rate_limits от политиката на магазина при издаването. Всички ключове споделят тези лимити; нов токен не ги нулира. Промяна на плана може да важи преди изтичането на токена.

Пример: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeНизНезадължително

Bearer. Схема за удостоверяване на върнатия токен.

const: "Bearer"
По подразбиране: "Bearer"Пример: "Bearer"

Допълнителни полета: Не

Ограничения на честотата

TokenRateLimitsData · Engine ≥ 4.143.0. Всеки отговор с токен съдържа data.rate_limits от политиката на магазина при издаването. Всички ключове споделят тези лимити; нов токен не ги нулира. Промяна на плана може да важи преди изтичането на токена. Нула означава недостъпност, а не неограничен достъп.
auth_per_minuteЦяло числоЗадължително

Заявки за токен в минута, включително неуспешните опити за удостоверяване.

minimum: 0maximum: 1000000
Пример: 10
read_per_minuteЦяло числоЗадължително

Заявки за четене в минута.

minimum: 0maximum: 1000000
Пример: 60
write_per_minuteЦяло числоЗадължително

Заявки за запис в минута; тази стойност не дава права за запис.

minimum: 0maximum: 1000000
Пример: 10

Допълнителни полета: Не

Получаване · Токен — Удостоверяване — Тяло на заявката

TokenRequest · Полета, типове и ограничения на данните, приемани или връщани от API.
ОбектДопълнителни полета: Не

Допълнителни полета: Не