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

П’ять хвилин від реєстрації до повної натальної карти в JSON.

1. Зареєструйся на astroway.info

   AstroWay API використовує єдиний обліковий запис з іншими продуктами екосистеми. Безкоштовний план дає 500 кредитів/міс без вводу картки.

2. Створи ключ у dashboard

   Кожен ключ починається з префіксу sk_live_ (production) або sk_test_ (sandbox, не списує кредити). Скопіюй ключ одразу — в open вигляді він показується лише раз.

   Обережно

   Ключ — це секрет. Не комітіть його в git, не вставляйте у фронтенд-код, не надсилайте в месенджери. Для фронтенду використовуй проміжний backend або короткоживучі session-токени (Phase 3).

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

   cURL

   first-request.sh

   curl -X POST https://api.astroway.info/v1/chart \
     -H "X-Api-Key: sk_live_your_key_here" \
     -H "Content-Type: application/json" \
     -d '{
       "datetime": "1990-07-14T14:30:00",
       "latitude": 50.4501,
       "longitude": 30.5234,
       "timezone": "Europe/Kyiv",
       "house_system": "placidus"
     }'

   Node.js

   first-request.ts

   const response = await fetch('https://api.astroway.info/v1/chart', {
     method: 'POST',
     headers: {
       'X-Api-Key': process.env.ASTROWAY_API_KEY!,
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({
       datetime: '1990-07-14T14:30:00',
       latitude: 50.4501,
       longitude: 30.5234,
       timezone: 'Europe/Kyiv',
       house_system: 'placidus',
     }),
   });
   
   const chart = await response.json();
   console.log(chart.planets.sun);

   Python

   first_request.py

   import os
   import requests
   
   response = requests.post(
       "https://api.astroway.info/v1/chart",
       headers={"X-Api-Key": os.environ["ASTROWAY_API_KEY"]},
       json={
           "datetime": "1990-07-14T14:30:00",
           "latitude": 50.4501,
           "longitude": 30.5234,
           "timezone": "Europe/Kyiv",
           "house_system": "placidus",
       },
   )
   chart = response.json()
   print(chart["planets"]["sun"])

   PHP

   first-request.php

   <?php
   use GuzzleHttp\Client;
   
   $client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
   
   $response = $client->post('chart', [
       'headers' => [
           'X-Api-Key'    => getenv('ASTROWAY_API_KEY'),
           'Content-Type' => 'application/json',
       ],
       'json' => [
           'datetime'     => '1990-07-14T14:30:00',
           'latitude'     => 50.4501,
           'longitude'    => 30.5234,
           'timezone'     => 'Europe/Kyiv',
           'house_system' => 'placidus',
       ],
   ]);
   
   $chart = json_decode((string) $response->getBody(), true);
   print_r($chart['planets']['sun']);

4. Прочитай відповідь

   Відповідь — повний JSON з позиціями планет, куспідами будинків, аспектами і метаданими. Приклад скорочено:

   {
     "meta": {
       "datetime_utc": "1990-07-14T11:30:00Z",
       "julian_day": 2448087.0,
       "house_system": "placidus"
     },
     "planets": {
       "sun":    { "longitude": 111.87, "latitude": 0.0, "speed": 0.95, "sign": "cancer",  "house": 10 },
       "moon":   { "longitude":  87.23, "latitude": -4.2, "speed": 13.3, "sign": "gemini",  "house":  8 },
       "mercury":{ "longitude": 135.40, "latitude": 2.1, "speed": 1.34, "sign": "leo",     "house": 11 }
     },
     "houses": [
       { "cusp":  12.34, "sign": "aries"  },
       { "cusp":  43.21, "sign": "taurus" }
     ],
     "aspects": [
       { "a": "sun", "b": "moon", "type": "sextile", "orb": 1.36, "applying": true }
     ]
   }

   Headers у відповіді:

   X-Credits-Used: 2
   X-Credits-Remaining: 498
   X-Credits-Reset: 2026-05-01T00:00:00Z
   X-Request-Id: 01HXY2A7ZM...

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

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

   curl https://api.astroway.info/v1/keys/usage \
     -H "X-Api-Key: sk_live_your_key_here"

Далі

• Автентифікація — best practices, ротація ключів, sandbox mode
• Кредити та ліміти — таблиця вартості, rate limiting, overage
• Приклади: натальна карта — детальний розбір /v1/chart
• Повна API reference — усі 87 ендпоінтів з playground