Quickstart

1. Получите API Keys

Свяжитесь с командой NurCore через partners@nurcore.kg (B2B) или developers@nurcore.kg (mobile/website). После подписания соглашения вам выдадут два ключа:

pk_live_* — publishable (для frontend / mobile bundle)
sk_live_* — secret (только для backend)

Подробнее в Authentication.

Дополнительно вы получите:

X-Client-Id — UUID вашей интеграции
X-Client-Type — agency / consumer_app / kiosk

2. Setup

export API="https://api.nurcore.kg/api/v1"
export KEY="sk_test_your_key_here"      # для разработки используйте sandbox
export CLIENT_ID="your_client_id"
export CLIENT_TYPE="agency"

3. Первый запрос — поиск аэропортов

Все endpoints (включая каталог) требуют API Key:

curl -H "X-API-Key: $KEY" \
     -H "X-Client-Id: $CLIENT_ID" \
     -H "X-Client-Type: $CLIENT_TYPE" \
     "$API/schedules/airports?search=BSZ"

Ответ:

{
  "data": [
    {
      "iata_code": "BSZ",
      "icao_code": "UCFM",
      "name": "Международный аэропорт «Манас»",
      "city": "Бишкек",
      "country": "Кыргызстан",
      "timezone": "Asia/Bishkek"
    }
  ],
  "count": 1
}

4. Поиск маршрутов

curl -H "X-API-Key: $KEY" \
     -H "X-Client-Id: $CLIENT_ID" \
     -H "X-Client-Type: $CLIENT_TYPE" \
     "$API/schedules/routes?origin=BSZ&destination=OSS"

5. Информация о рейсе

curl -H "X-API-Key: $KEY" \
     -H "X-Client-Id: $CLIENT_ID" \
     -H "X-Client-Type: $CLIENT_TYPE" \
     "$API/schedules/flights/{flight_id}"

6. Создание брони

Полный пример см. Booking flow.

Дальше

Authentication — детали публичных и секретных ключей, BFF паттерн
Rate limits — лимиты по типам ключей
Booking flow — полный пример бронирования
Online check-in — для mobile / website