Быстрый старт

1. Получите ключ

   Ключ создаётся в кабинете Govza: API-ключи → Создать ключ. Он показывается один раз — сохраните его сразу.

2. Проверьте ключ

   curl https://api.govza.app/v1/delivery/ping \
     -H "Authorization: Bearer $GOVZA_KEY"

   В ответе — аккаунт, от имени которого работает ключ:

   {
     "success": true,
     "data": {
       "ok": true,
       "account": { "id": "…", "email": null },
       "scopes": ["orders:write"],
       "rate_limit_per_minute": 120
     }
   }

   Ответ 401 означает, что ключ неверный, отозван или его аккаунт больше не может создавать заказы.

3. Узнайте стоимость

   curl -X POST https://api.govza.app/v1/delivery/quotes \
     -H "Authorization: Bearer $GOVZA_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "pickup":   { "latitude": 43.342439, "longitude": 45.693597 },
       "dropoffs": [{ "latitude": 43.320872, "longitude": 45.691756 }]
     }'

   В ответе — цена, quote_id и срок действия расчёта.

4. Создайте доставку

   Здесь уже нужны полные адреса и контакты:

   curl -X POST https://api.govza.app/v1/delivery/orders \
     -H "Authorization: Bearer $GOVZA_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "external_order_id": "SHOP-10432",
       "quote_id": "<quote_id из шага 3>",
       "payment_type": "cash",
       "payment_amount": 1500,
       "comment": "Позвонить за 10 минут",
       "pickup": {
         "address": {
           "latitude": 43.342439, "longitude": 45.693597,
           "area": "Грозный", "street": "А. А. Айдамирова", "building": "123"
         },
         "contact": { "value": "+79280003396", "name": "Адам" }
       },
       "dropoffs": [{
         "address": {
           "latitude": 43.320872, "longitude": 45.691756,
           "area": "Грозный", "street": "С. Ш. Лорсанова", "building": "12",
           "apartment": 4, "entrance": 2, "floor": 3
         },
         "contact": { "value": "+79280003396", "name": "Милана" }
       }]
     }'

   В ответе — код заказа Govza, итоговая цена и ссылка для отслеживания, которую можно передать получателю. Сохраните её: при чтении заказа новая ссылка не создаётся.

5. Следите за заказом

   curl https://api.govza.app/v1/delivery/orders/SHOP-10432 \
     -H "Authorization: Bearer $GOVZA_KEY"

   Или настройте Webhook, чтобы получать изменения статуса сразу, без опроса.