# Văn bản biểu đồ sinh nhật

`GET /v1/natal-texts` trả về các bản diễn giải đã sẵn sàng cho các vị trí trên bản đồ. Các văn bản này được viết và chỉnh sửa trước đó, không có gì được tạo ra theo yêu cầu.

## Yêu cầu

```http
GET /v1/natal-texts?keys=sun.aries,moon.h4,sun_moon.trine&lang=uk HTTP/1.1
X-Api-Key: aw_live_...
```

- `keys`: đến 64 khóa khác nhau, cách nhau bằng dấu phẩy.
  - hành tinh trong cung: `sun.aries`, cũng như `chiron.leo`, `ascendant.virgo`;
  - hành tinh trong nhà: `moon.h4`;
  - khía cạnh giữa hai hành tinh từ Sun..Pluto: `sun_moon.trine` (conjunction, sextile, square, trine, opposition). Thứ tự của cặp không quan trọng, `moon_sun` sẽ trở thành `sun_moon`.
- `lang`: bắt buộc, một trong 20 ngôn ngữ của trang web.

## Phản hồi

```json
{
  "lang": "uk",
  "texts": {
    "sun.aries": { "title": "Сонце в Овні", "body": "…", "kind": "planet_in_sign" }
  },
  "missing": ["moon.h4", "sun_moon.trine"]
}
```

Văn bản không có bằng ngôn ngữ được yêu cầu sẽ được đưa vào `missing`. Chúng tôi không thay thế bằng ngôn ngữ khác. `body` là văn bản thông thường, các đoạn được phân cách bằng dòng trống.

## Những gì đã có sẵn

Hành tinh trong cung: 144 văn bản bằng hai mươi ngôn ngữ. Hành tinh trong nhà và các khía cạnh đang được viết và sẽ xuất hiện cùng điểm cuối này.

## Giá và bộ nhớ cache

`/v1/natal-texts` có giá như một cuộc gọi thông thường (10 tín dụng), bất kể có bao nhiêu khóa. Các phản hồi có khóa không được lưu vào bộ đệm CDN (`Cache-Control: no-store`), vì vậy hãy lưu trữ văn bản của riêng bạn theo khóa và ngôn ngữ: văn bản chỉ thay đổi sau khi được chỉnh sửa.