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

Кто я

GET /api/v1/me

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

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

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

Поля ответа

Поле	Тип	Что это
`sellerId`	`string`	Внутренний номер продавца.
`nickname`	`string\|null`	Ник, который видит покупатель.
`isTest`	`boolean`	Тестовая роль: сделки не настоящие, а карточки рождаются тестовыми.
`sellerType`	`string\|null`	ooo, ip или self_employed.
`sellerStatus`	`string\|null`	pending, active, suspended или blocked.
`listable`	`boolean`	Пускают ли карточки на витрину прямо сейчас.
`blockers`	`array`	Чего не хватает до витрины. Пустой список — всё в порядке. Считает то же ядро, что и витрина.
`scopes`	`array`	Что умеет ИМЕННО ЭТОТ ключ.

Пример

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

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

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

GET /api/v1/catalog/services — Поиск позиции справочника
GET /api/v1/catalog/services/{slug} — Всё о позиции справочника
GET /api/v1/catalog/usual-price — Обычная цена по позиции
GET /api/v1/catalog/demand — Спрос: чего ждут покупатели
GET /api/v1/catalog/requests — Свои заявки на позицию каталога
POST /api/v1/catalog/requests — Заявка на новую позицию каталога