Public API
  1. Заказы
Public API
  • Public API
    • Главная
    • Клиенты
      • Добавить клиента
    • Услуги
      • Добавить услугу
      • Удалить услугу
      • Список услуг
      • Обновить услугу
    • Расчет стоимости
      • Расчет стоимости
    • Заказы
      • Cписок заказов
        GET
      • Заказ по ID
        GET
      • Разместить заказ
        POST
    • Schemas
      • Client
      • Order
      • OrderStatus
      • PriceCalc
      • RoutePoint
      • Service
      • SuccessApiResponse
      • SuccessApiResponseList
      • ErrorApiResponse
  1. Заказы

Разместить заказ

POST
/orders

Размещение заказа#

Новый заказ получает статус created по умолчанию и попадает в автораздачу или в ручной поиск (в зависимости от настроек услуги)
Параметр scheduledAt является необязательным. При его передаче заказ планируется на конкретную дату и время и получает статус scheduled.
При размещении заказа используется информация из предварительного расчета стоимости, идентификатор которого передается в параметре priceId. Подробнее тут Расчет стоимости

Request

Authorization
API Key
Add parameter in header
x-apis-key
Example:
x-apis-key: ********************
or
Body Params application/json

Examples

Responses

🟢200OK
application/json
Успешная операция
Body

🟠400Bad Request
🟠403Forbidden
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.masterdru.ru/orders' \
--header 'x-apis-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "priceId": "6713f1a7-5ab3-42d5-9785-53f35583771c",
    "clientComment": "cillum culpa"
}'
Response Response Example
200 - Example 1
{
    "id": "942aa8a4-5726-49f0-bfda-11eda7271e27",
    "createdAt": "2025-10-08T20:33:45.695Z",
    "num": "PL-113132",
    "clientName": "q",
    "clientPhone": "79177563397",
    "serviceId": "7da55582-f2f5-4ee4-a616-2e00e4464670",
    "priceId": "f7715c5d-d20f-42e4-a967-d76844b49949",
    "tariffId": "986e61c8-ce41-4690-aa29-d4ea64f43c37",
    "serviceName": "tabernus",
    "supplierId": "756a322c-ab75-4720-a345-ad726653ce10",
    "supplierName": "Moses Johnson",
    "supplierPhone": "79483688394",
    "scheduledAt": "2025-10-08T20:33:45.697Z",
    "paymentType": "account",
    "currencyCode": "USD",
    "calcAmount": 333.09,
    "routePoints": [
        {
            "id": "50b815b9-8b37-4ffb-9234-ad16a91d407a",
            "lat": -30.1661,
            "lng": -97.5684,
            "address": "1648 East Street"
        },
        {
            "id": "6b5e2b21-2946-4ed7-b325-a6c04ce0e7df",
            "lat": 83.9925,
            "lng": 108.8687,
            "address": "187 Franklin Road"
        }
    ],
    "status": "created",
    "clientComment": "Suffoco facilis ver defetiscor suadeo alii curriculum stips tametsi canonicus.",
    "totalDistance": 5231,
    "totalTime": 42,
    "totalAmount": 571.95
}
Modified at 2025-10-08 19:17:46
Previous
Заказ по ID
Next
Client
Built with