Рефсейлс API
Справочники

Изменить способ доставки

PATCH
/api/v1/references/delivery-types/{id}

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

Авторизация

bearerApiKey
headerАвторизацияBearer <ключ>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API-ключи.

Параметры пути

id*string

ID записи.

Тело запроса

application/json
  1. body
name?string

Новое название. Изменится во всех магазинах владельца.

Length1 <= length <= 100
kind?string

Вид доставки. У способа с интеграцией не меняется.

Value in"courier""pickup""carrier"
code?string

Код латиницей: строчные буквы, цифры и _, до 50 символов. Без кода его придумает Рефсейлс.

Match^[a-z0-9_]{1,50}$
isActive?boolean

Включить или выключить способ. Если способ доступен во всех магазинах владельца, переключится во всех; если только в выбранных, то только в этом.

Ответ

Запись после изменения.

application/json
  1. response
data*
curl -X PATCH "https://example.com/api/v1/references/delivery-types/string" \  -H "Content-Type: application/json" \  -d '{    "name": "Курьер по Петербургу и области"  }'
{  "data": {    "id": "9b3e6d1a-4c8f-4a2e-9d7b-3f1c5a8e2d60",    "code": "spb_courier",    "name": "Курьер по Петербургу",    "kind": "courier",    "provider": null,    "isActive": true  }}

Создать способ доставки POST

Способы доставки общие для всех магазинов владельца. Через API создаётся способ без интеграции: СДЭК и Яндекс Доставка подключаются в настройках. Право: references:write.

Склады GET

Склады и точки отгрузки магазина. id передавайте в delivery.warehouseId при создании заказа. Список короткий, поэтому приходит одной страницей. Право: references:read.