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

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

Ключ создаёт клиент Govza в личном кабинете: API-ключи → Создать ключ.

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

curl https://api.govza.app/v1/partner/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/partner/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 }]
  }'

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

Для создания заказа нужны полные адреса и контакты.

curl -X POST https://api.govza.app/v1/partner/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/partner/orders/SHOP-10432 \
  -H "Authorization: Bearer $GOVZA_KEY"

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