Получение информации по заявкам

Метод GET <BASE_LOAD_API>/get позволяет получить информацию по одной или нескольким заявкам. С его помощью можно узнать:

  • Текущий статус заявки;

  • Комментарии операторов: дата создания и текст каждого комментария. У одной заявки может быть несколько комментариев, оставленных операторами в разное время;

  • Связанные записи справочника customer (список ID);

  • Общую информация по заявке: описание, дата создания, дата обновления.

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

Параметры метода

  • ids (опционально) — идентификатор заявки, для которой требуется получить информацию. Можно указать несколько. При отсутствии будет выдана информация по всем доступным заявкам.

Пример

Запрос через curl

curl -X GET "https://app.sellout.plus/universe/api/request/get?ids=107800,107801" ^ 
    -H "Authorization: Bearer <ваш_токен>"

Успешный ответ

[
  {
      "ID_Request": 107800,
      "Description": "Объединить записи",
      "Status": {
          "Code": "rq.Request.DN",
          "Name": "Done"
      },
      "DateCreate": "2025-01-01 12:31:42",
      "DateUpdate": "2025-01-02 14:51:24",
      "Comments": [
          {
              "Comment": "Проверим в течение дня",
              "DateCreate": "2025-01-01 12:35:32"
          },
          {
              "Comment": "Точки объединены",
              "DateCreate": "2025-01-02 14:51:24"
          }
      ],
      "LinkedRecords": [85634534]
      // Связанная запись в данном случае будет одна, так как вторая была удалена в рамках объединения
  },
  {
      "ID_Request": 107801,
      "Description ": "Исправить опечатку в наименовании",
      "Status": {
          "Code": "rq.Request.IP",
          "Name": "In Progress"
      },
      "DateCreate": "2025-01-04 10:21:56",
      "DateUpdate": "2025-01-04 10:21:56",
      "Comments": [],
      "LinkedRecords": [85634534, 85634567]
  }
]

Статусы заявок

Код статуса

Описание

Значения

rq.Request.OP

Открыта

Open

rq.Request.IP

В работе

In Progress

rq.Request.CF

Уточнение

Clarification

rq.Request.RV

Ревью

Review

rq.Request.DN

Закрыто

Done

Коды ошибок

Код ошибки

Описание

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

401

Не удалось авторизоваться

{
    "status": 401,
    "status_description": "Unauthorized",
    "error_message": "The request is unauthenticated."
}

500

Внутренняя ошибка сервера.

{
   "status": 500,
   "status_description": "InternalServerError",
   "error_message": "Unexpected error occurred"
}