Избранное

Platitun · API · Справочник и заявки · Кто я

Кто я

GET /api/v1/me

Область ключа: catalog · только чтение

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

Ответ этого пути — самый быстрый способ понять, почему услуга не появилась на витрине: смотрите blockers, а не догадывайтесь.

passport — самозанятый или ИП не заполнил паспортные данные для банка либо заполнил их до 29.09.2026, без фамилии, имени и отчества. Приходит только пока площадка собирает паспорта. Заполняются в кабинете, в разделе «Документы и реквизиты»: пути API для паспортных данных нет.

bank_consent — самозанятый или ИП не дал согласия на передачу персональных данных в банк в действующей редакции. Дать его можно только в кабинете, в разделе «Документы и реквизиты»: программой согласие не даётся, это личное действие человека.

Поля ответа

ПолеТипЧто это
sellerIdstringВнутренний номер продавца.
nicknamestring|nullНик, который видит покупатель.
isTestbooleanТестовая роль: сделки не настоящие, а карточки рождаются тестовыми.
sellerTypestring|nullooo, ip или self_employed.
sellerStatusstring|nullpending, active, suspended или blocked.
listablebooleanПускают ли карточки на витрину прямо сейчас.
blockersarrayЧего не хватает до витрины: nickname, offer, status, inn, registry_confirm, payout, passport, bank_consent. Пустой список — всё в порядке. Считает то же ядро, что и витрина.
scopesarrayЧто умеет ИМЕННО ЭТОТ ключ.

Пример

GET /api/v1/me
Authorization: Bearer ptk_…

→ 200 {
  "nickname": "seller_A",
  "isTest": true,
  "listable": true,
  "blockers": [],
  "scopes": ["catalog","listings","stats"]
}

Рядом в этом разделе