Рефсейлс API
Диагностика

Проверить ключ

GET
/api/v1/credentials

Показывает, какому магазину принадлежит ключ, какие у него права и до когда он действует. Секрет не возвращается. Подходит для проверки подключения: нужен только рабочий ключ, без отдельного права.

Авторизация

bearerApiKey
headerАвторизацияBearer <ключ>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API-ключи.

Ответ

Данные ключа.

application/json
  1. response
shopId*string

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

shopSlug*|

Поддомен магазина на refsales.ru.

keyId*string

ID ключа.

keyPrefix*string

Начало ключа для опознания. Сам секрет API не возвращает.

scopes*array<string>

Права ключа, например orders:read.

expiresAt*|

Когда ключ перестанет работать, ISO 8601. null, если срока нет.

curl -X GET "https://example.com/api/v1/credentials"
{  "shopId": "7c1f0a9e-5b2d-4e3c-8f6a-0d9b2c4e1a75",  "shopSlug": "candles",  "keyId": "e2a9c4f1-6b3d-4a7e-9c5f-1d8b0e2a6c43",  "keyPrefix": "rsk_live_a1b2c3d4",  "scopes": [    "orders:read",    "orders:write",    "references:read"  ],  "expiresAt": null}