Справочник причин возврата

GET https://mrp.zolotenkov.ru/api/external/v1/sales-return-reasons

Требуемое право ключа: read:sales

Системный список причин, из которого выбирается items[].reason_id. Состав общий для всех учетов: свои значения тенант не добавляет, иначе разрез «за что возвращают» перестал бы быть сравнимым. Ручек изменения справочника наружу нет.

Ответы

200 Действующие значения справочника причин возврата
401 Ключ не передан, недействителен или отозван
403 У ключа нет права read:sales
429 Превышена частота обращений. Задержка до повтора — в заголовке Retry-After

Язык

Ключ

Подставляется в пример прямо в браузере. Ключ никуда не отправляется и нигде не сохраняется.

Запрос

curl --request GET \
  --url 'https://mrp.zolotenkov.ru/api/external/v1/sales-return-reasons' \
  --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \
  --header 'Accept: application/json'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/sales-return-reasons", {
  method: "GET",
  headers: {
    "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ",
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://mrp.zolotenkov.ru/api/external/v1/sales-return-reasons",
    headers={
    "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

<?php
$curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/sales-return-reasons');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ",
        "Accept: application/json",
    ],
]);

$response = curl_exec($curl);
var_dump(json_decode($response, true));

Ответ

{
  "data": [
    {
      "id": 2,
      "name": "Брак или повреждение"
    }
  ]
}

{
  "error": "unauthorized",
  "message": "Missing Authorization header",
  "request_id": "req_cyX5W3UaT8KsYDN7GUEkdW"
}

{
  "error": "forbidden",
  "message": "Missing required scope 'read:sales'",
  "request_id": "req_cyX5W3UaT8KsYDN7GUEkdW"
}

{
  "error": "rate_limited",
  "message": "Rate limit exceeded",
  "request_id": "req_cyX5W3UaT8KsYDN7GUEkdW"
}

Примеры собраны из схем ответов. Машинная форма — в спецификации OpenAPI.