API Reference v1
Авторизация запросов
Как передавать API-ключ магазина и какой базовый URL использовать.
Базовый URL
https://app.ketmus.com/api/merchant/v1Все методы принимают и возвращают JSON. Для методов с телом передавайте заголовок Content-Type: application/json.
Заголовок авторизации
Передавайте API-ключ магазина в заголовке Authorization с префиксом Bearer. Отдельный запрос для получения токена не нужен — ключ передаётся в каждом запросе.
Authorization: Bearer XXXXXX-XXXXXX-XXXXXX-XXXXXXКлюч магазина — из таблицы Merchant API-ключи в личном кабинете, вида K7P2QX-9DMW4R-T3ZB8N-H6VY5C. Подробнее — Получение API-ключа.
Если ваш HTTP-клиент не позволяет задать Authorization, используйте альтернативный заголовок X-API-Key: <key>.
Пример запроса
curl "https://app.ketmus.com/api/merchant/v1/me" \
-H "Authorization: Bearer $KETMUS_API_KEY"Ответ
{
"store": {
"id": 42,
"name": "My Shop"
},
"accepted_rails": [
"usdt_tron",
"usdt_ton",
"btc",
"eth",
"ton"
],
"webhook_url": "https://shop.example.com/webhooks/ketmus",
"fee_payer": "payer",
"lifetime_sec": 3600
}Ошибки авторизации
| HTTP | code | Причина |
|---|---|---|
| 401 | unauthorized | Ключ не передан, имеет неверный формат или не найден |
| 403 | inactive | Магазин отключён |
| 429 | rate_limited | Превышен лимит 300 запросов в минуту |