इसे छोड़कर कंटेंट पर जाएं
AstroWay/api v2.158.7 · hi
सभी सिस्टम सामान्य हैं

Швидкий старт

यह कंटेंट अभी तक आपकी भाषा में उपलब्ध नहीं है।

П’ять хвилин від реєстрації до повної натальної карти в JSON. Покриває install SDK, перший запит, заголовки відповіді, автентифікацію та обробку помилок.

  1. Згенеруй API ключ

    Section titled “Згенеруй API ключ”

    Зайди в dashboard і натисни Generate key. Безкоштовний тариф дає 10 000 кредитів/міс назавжди - без введення картки. Ключі починаються з:

    • aw_live_*: production, реальні чарджі
    • aw_test_*: sandbox, без списання кредитів, детермінована відповідь

  2. Постав SDK

    Section titled “Постав SDK”

    API - звичайний REST + JSON, тож SDK не обов’язковий. MCP сервер (@astroway/mcp) вже зрелізений для AI-агентських інтеграцій. TypeScript і Python SDK у roadmap (auto-gen з OpenAPI 3.1) - поки що native HTTP.

    Terminal window
    # SDK не потрібен - лише curl та ключ:
    export AW_KEY="aw_test_demo_replaceme"

  3. Зроби перший запит

    Section titled “Зроби перший запит”

    Розрахунок натальної карти для 24 серпня 1991, 16:30 EEST, Київ:

    first-request.sh
    curl -X POST https://api.astroway.info/v1/chart \
      -H "X-Api-Key: $AW_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1991-08-24",
        "time": "16:30:00",
        "timezoneOffset": 3,
        "latitude": 50.4501,
        "longitude": 30.5234,
        "houseSystem": "P"
      }'

  4. Розбери відповідь

    Section titled “Розбери відповідь”

    Кожна відповідь - JSON з планетами, будинками, аспектами та meta-блоком (cache hit, credits, engine version).

    response.json
    {
      "ok": true,
      "data": {
        "julianDay": 2448493.0625,
        "planets": [
          { "id": 0, "name": "Sun", "longitude": 150.894819, "latitude": 0.00019, "isRetrograde": false, "declination": 11.15726 },
          { "id": 1, "name": "Moon", "longitude": 321.634655, "latitude": 2.834053, "isRetrograde": false, "declination": -11.609723 }
        ],
        "houses": {
          "system": "P",
          "cusps": [264.384681, 306.997683, 353.867426],
          "ascendant": 264.384681,
          "mc": 207.315669
        },
        "aspects": [
          {
            "planet1": "Sun",
            "planet2": "Moon",
            "type": { "name": "Opposition", "angle": 180, "isMajor": true },
            "exactAngle": 170.739837,
            "orb": 9.260163,
            "isApplying": true
          }
        ],
        "chartSect": "diurnal",
        "meta": { "engineVersion": "2.10.03", "calculatedAt": "2026-08-22T20:53:31.431Z" }
      }
    }

  5. Перевір баланс

    Section titled “Перевір баланс”

    Dashboard показує usage в реальному часі: api.astroway.info/dashboard. Або через API:

    Terminal window
    curl https://api.astroway.info/v1/keys/usage \
      -H "X-Api-Key: $AW_KEY"

Authentication

Section titled “Authentication”

AstroWay API автентифікує запити через заголовок X-Api-Key. Bearer-токени та query-string ключі не підтримуються.

Terminal window
curl -H "X-Api-Key: aw_live_..." https://api.astroway.info/v1/health
Тип ключаПрефіксПоведінка
Productionaw_live_*Виставляє реальні кредити з акаунту
Sandboxaw_test_*Детермінована мокова відповідь, без charge
Restricted (Pro+)aw_live_* з обмеженнямОбмежений на конкретні endpoints / IP / RPS

Ключі обертаються без downtime - старий ключ продовжує працювати 24 години після генерації нового. Деталі: /authentication/.

Errors

Section titled “Errors”

Усі помилки повертаються у форматі ok: false + об’єкт error. Поле error.code (UPPER_SNAKE_CASE) стабільне для скриптів - свіч по ньому, не по message.

error-response.json
{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Invalid input: expected string, received undefined",
    "details": [
      { "path": "date", "message": "Invalid input: expected string, received undefined" }
    ]
  }
}

Найчастіші коди:

  • INVALID_INPUT (400): провалена Zod-валідація; details містить масив { path, message }
  • INVALID_API_KEY (401): ключ не існує або revoked
  • PLAN_UPGRADE_REQUIRED (402): потрібен вищий тариф або add-on пак
  • CREDITS_EXHAUSTED (429): місячний бюджет кредитів вичерпано
  • RATE_LIMIT (429): перевищено RPM; повертається з заголовком Retry-After: <sec>
  • internal_calc_error (500): помилка ефемерид; авто-retry на стороні SDK

Повний список і semantic: /errors/.

Rate limits

Section titled “Rate limits”
ТарифQuota
Free10 req/min
Indie30 req/min
Starter120 req/min
Pro400 req/min
Business1 000 req/min
Enterprisecustom

Перевищення → 429 з Retry-After (sec). Офіційні SDK мають exponential-backoff retries за замовчуванням. Деталі: /rate-limits-credits/.

Далі

Section titled “Далі”
उपयोगी रहा?
Запропонувати правку

आखिरी अद्यतन: