Platitun · API · Карточки услуг · Завести карточку

Завести карточку

POST /api/v1/listings

Область ключа: listings · изменяет данные, нужен заголовок Idempotency-Key

Новая карточка услуги. Рождается ВЫКЛЮЧЕННОЙ — включение остаётся отдельным действием, потому что именно оно делает вашу цену публичной офертой: по ней вы обязаны продать. Допустимые значения полей отдаёт путь позиции справочника.

🔴 Самозанятому доступны ВСЕ виды услуг (08.09.2026): предметом сделки является услуга, которую продавец оказывает по заказу покупателя, а не перепродажа товара или имущественного права. Прежнее ограничение «только подписка на почту покупателя» ОТМЕНЕНО. Отказ self_employed_forbidden остаётся в перечне на случай, если допуск когда-нибудь сузят.

Контакты в описании не проходят: увод сделки за пределы площадки лишает покупателя защиты, а продавца — гарантии.

Поля запроса

Поле	Тип	Что это
`service` обязательно	`string`	Короткое имя сервиса из справочника.
`tariff`	`string`	Короткое имя плана вендора. Обязателен у подписки и аккаунта с подпиской.
`productType` обязательно	`string`	subscription, account, account_with_subscription или credits.
`deliveryMethod` обязательно	`string`	Способ выдачи. Что чему подходит — в ответе позиции справочника.
`priceRub` обязательно	`integer`	Цена в рублях целым числом.
`slaMinutes` обязательно	`integer`	За сколько минут обещаете выдать. Только из allowed списка.
`guaranteeDays` обязательно	`integer`	Срок гарантии в днях. Только из allowed списка.
`description`	`string`	Своё описание услуги. Оно же выводит карточку в карту сайта: продавец получает выгоду от того, что описал услугу.
`confirmRequired`	`boolean`	Нужно ли ваше подтверждение перед оплатой.
`ratePer1000Rub`	`integer`	Для токенов: курс за тысячу.
`amountMin`	`integer`	Для токенов: наименьший объём.
`amountMax`	`integer`	Для токенов: наибольший объём.

Поля ответа

Поле	Тип	Что это
`number`	`integer`	Публичный номер новой карточки.
`isActive`	`boolean`	Всегда false: карточка рождается выключенной.
`isTest`	`boolean`	Карточка тестового продавца рождается тестовой.

Поводы отказа

Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.

Код	Что случилось и что делать
`complaint`	Правила карточки не сошлись: например, способ выдачи не подходит виду услуги или срок вне допустимого списка. Допустимые значения отдаёт путь позиции справочника.
`contacts`	В тексте найдены контакты — почта, телефон, ссылка на мессенджер. Увод сделки за пределы площадки лишает покупателя защиты, а продавца гарантии. Уберите контакты и отправьте снова.
`no_service`	Такой позиции в справочнике нет. Найдите её поиском по справочнику или заведите заявку.
`type_not_available`	У этой позиции такого вида услуги не бывает. Возможные виды — в ответе позиции справочника.
`no_tariff`	Для подписки и аккаунта с подпиской нужен план вендора. Список планов — в ответе позиции справочника.
`self_employed_forbidden`	Этот вид услуги недоступен статусу продавца. Самозанятому доступны ВСЕ виды услуг площадки: предметом сделки является услуга, которую продавец оказывает по заказу покупателя, а не перепродажа товара или имущественного права.
`self_employed_giftcode`	Самозанятому выдача промокодом недоступна: подарочный код, купленный заранее, — это передача имущественного права (п. 1.3 оферты продавца). Выберите другой способ выдачи. Тот же отказ приходит при правке, копии и включении карточки с промокодом, заведённой до смены статуса.

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

GET /api/v1/listings — Свои карточки
GET /api/v1/listings/{number} — Одна своя карточка
PATCH /api/v1/listings/{number} — Правка карточки
DELETE /api/v1/listings/{number} — Убрать карточку
POST /api/v1/listings/{number}/state — Включить или выключить показ
POST /api/v1/listings/{number}/copy — Копия карточки
POST /api/v1/listings/{number}/test — Пометить карточку тестовой
PUT /api/v1/listings/{number}/image — Картинка карточки
DELETE /api/v1/listings/{number}/image — Убрать картинку
GET /api/v1/questions — Вопросы по своим карточкам
POST /api/v1/questions/{id}/answer — Ответить на вопрос