Перейти к основному содержанию
PUT
Replace the list of suppliers switched off
Заменяет список поставщиков, выключенных для вашего аккаунта. Каждый раз отправляйте список целиком: присланные номера выключены, все остальные включены. Пустой массив включает всех обратно. Изменение действует со следующего запроса. Оно применяется к листингам, глубине, ценам, обоим снапшотам и потоку. Номера берите из GET /v1/sources.
Это фильтр того, что вам показывают, а не запрет покупки. Id листинга, отправленный в POST /v1/orders, покупается независимо от поставщика.
Требуется аутентификация. Передавайте ключ как Authorization: Bearer csb_pub_....

Тело запроса

integer[]
обязательно
Номера поставщиков, которых нужно выключить. Номер, которого нет в использовании, отклоняется, чтобы опечатка не выключила «ничего» незаметно.

После изменения

  • Поток. Соединение живёт со списком, с которым было открыто. Переподключитесь, чтобы применить новый, и удалите из своей копии листинги выключенных поставщиков: их gone не придёт.
  • Снапшоты. Снапшот листингов собирается под каждый список. Список, которым ещё никто не пользовался, отвечает 202 snapshot_building, пока файл не готов.

Пример запроса

Пример ответа

Коды ошибок

Авторизации

Authorization
string
header
обязательно

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-RateLimit-Bucket for the bucket the call spent. See Rate limits.

Тело

application/json
sources_off
integer[]
обязательно

Supplier numbers to switch off, from GET /sources. A number that is not in use is refused.

Ответ

Saved.

data
object