# Звіт по каменях (ратна) у PDF

Джйотіш-призначення каменя як документ, який клієнт залишає собі. Кожен рекомендований камінь отримує сторінку: що класично означає його граха, підстава у володінні домами, мінерал і замінники, вага в ратті з переведенням у грами й карати, день тижня, палець, метал, мантра і найближчий сприятливий день для першого вдягання.

## Ендпоінт

`POST /v1/reports/gemstone`

- Operation ID: `reports-gemstone`
- Вартість: 5000 кредитів (тариф 7)
- Типова латентність: 1540 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/gemstone-report/

## Що обчислює

Астрологія тут дослівно та сама, що й у JSON-ендпоінті, і тест звіряє їх по всьому зодіаку для обох шкіл, щоб вони не розійшлися: той самий сидеричний лагна, ті самі правила, ті самі три камені. Документ додає те, чого таблиця не несе. Кожен камінь отримує традиційні значення своєї грахи, а не твердження про дію каменя, і дату першого вдягання, знайдену скануванням панчанги: найближчий сприятливий день, що припадає саме на день тижня цієї грахи. Якщо в межах вікна такого дня немає, звіт про це каже, а не друкує дату, яка день тижня проігнорувала, бо на папері ці дві виглядають однаково.

## Коли використовувати

Беріть як платний рівень поверх JSON: застосунок може намалювати призначення сам, а це артефакт, за який платить і який зберігає клієнт. Це ще й чесніша форма для ремедії, бо в документі є місце для межі, якої немає в полі JSON: тотожність каменя, обробку і вагу підтверджує геммолог, і жоден камінь не замінює медичної допомоги.

## Параметри запиту

| Parameter | Type | Required | Description |
|---|---|---|---|
| `chart` | object | yes | The birth chart. Coordinates are required and never defaulted: the whole prescription is derived from the lagna. |
| `school` | string | no | `lagna-lord` (default) or `functional-benefic`. Both reach the same three gems and withhold different ones. The school is printed on the cover. |
| `wearingFrom` | string | no | Date to search the first-wearing days from, YYYY-MM-DD. Defaults to today. The search runs 60 days. |
| `language` | string | no | One of the 21 report locales. The body prose ships in uk, en and ru; anything else reads the English. |
| `whitelabel` | boolean | no | Apply the caller's stored branding to the document. |
| `format` | "html" (query) | no | Add ?format=html to stream the document instead of rendering a PDF. |

## Приклад запиту

```bash
curl -X POST https://api.astroway.info/v1/reports/gemstone \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "chart": {
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52
  },
  "school": "lagna-lord",
  "wearingFrom": "2026-09-01",
  "language": "en"
}'
```

## Приклад відповіді

```json
{
  "ok": true,
  "data": {
    "url": "https://api.astroway.info/reports/abc-gemstone.pdf",
    "storage_key": "reports/abc-gemstone.pdf",
    "byte_length": 135145,
    "page_count": 7,
    "duration_ms": 1537,
    "expires_at": "2026-08-14T06:33:00.000Z"
  }
}
```

## Нотатки

Школа названа на обкладинці навмисно. Дві школи призначають ті самі камені й утримують різні, тож документ, який приховав би, котра з них його зробила, був би менш чесним за дані, з яких він зібраний. Під школою господаря лагни таблиця володінь узагалі не показує колонку функціональної ролі, замість того щоб тягнути вердикт іншої школи, який читався б як «не носіть діамант» у звіті, що цього не казав. Координати обов'язкові: призначення, збудоване на 0N 0E, це впевнений документ про чужий асцендент, і, на відміну від поля в JSON, PDF залишається у клієнта.

## Пов’язані техніки

- https://api.astroway.info/astrology-api/vedic-shadbala/
- https://api.astroway.info/astrology-api/varshaphal/
- https://api.astroway.info/astrology-api/vedic-dasha/

---

Повна машиночитана специфікація: https://api.astroway.info/v1/openapi.json
Інструкції для агента: https://api.astroway.info/AGENTS.md