Platitun · API · Документы и реквизиты · Ник продавца

Ник продавца

PUT /api/v1/papers/nickname

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

То, чем вас видит покупатель. Буквы двух алфавитов, цифры, дефис и подчёркивание, от трёх до двадцати четырёх знаков. Занятый ник не отдаётся.

Единственность держит замок базы, а не проверка перед записью: двое, нажавшие одновременно, оба прошли бы проверку. Поэтому nick_taken приходит и там, где секунду назад ник был свободен.

Поля запроса

Поле	Тип	Что это
`nickname` обязательно	`string`	Новый ник.

Поля ответа

Поле	Тип	Что это
`nickname`	`string`	Что записано.

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

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

Код	Что случилось и что делать
`nick_rule`	Ник не по правилу: буквы двух алфавитов, цифры, дефис и подчёркивание, от трёх до двадцати четырёх знаков.
`nick_taken`	Ник занят. Единственность держит замок базы, поэтому отказ приходит и там, где секунду назад ник был свободен.

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

GET /api/v1/papers — Свой порог продавца
POST /api/v1/papers/offer — Принять оферту продавца
PUT /api/v1/papers/status — Статус и налоговый номер
POST /api/v1/papers/registry-confirm — Подтвердить наименование
PUT /api/v1/papers/payout — Реквизиты выплат