# Zapier

Zap yang mengambil tanggal, waktu, zona dan koordinat kelahiran dari trigger, meminta peta dari API dan mengubah Ascendant menjadi nama zodiak. Permintaan di bawah ini dikirim ke produksi dalam bentuk yang sama seperti yang disusun oleh langkah; langkah-langkah di Zapier ditulis sesuai dokumentasi Zapier per 2026-09-17.

<Aside type="caution" title="Потрібен платний тариф Zapier">
API by Zapier, Webhooks by Zapier dan Formatter adalah aplikasi premium. Dokumentasi Zapier menandakan ketiga tersebut tidak tersedia pada paket Free, dan langkah Lookup Table memerlukan paket Professional atau lebih tinggi. Pada paket Free, gunakan [Make](/integrations/make/) atau [n8n](/integrations/n8n/).
</Aside>

Buat terlebih dahulu kunci, seperti yang dijelaskan di bagian [Kunci untuk Otomasi](/integrations/#ключ-для-автоматизації), dengan cakupan `chart`.

## 1. Letakkan kunci dalam koneksi

Header yang dimasukkan ke langkah Webhooks by Zapier disimpan di langkah itu sendiri, dan terlihat oleh setiap orang yang memiliki akses ke Zap. API by Zapier menyimpannya dalam koneksi.

1. Pada halaman **Apps**, klik **+ Add connection** dan pilih **API by Zapier**.
2. **Authentication type**: Static Headers (API key).
3. **Headers**: `X-Api-Key: ` lalu kunci Anda, dalam satu baris.
4. **Domain filter**: `api.astroway.info`, sehingga koneksi tidak dapat dialihkan ke tempat lain.

## 2. Panggil peta

Tambahkan tindakan, pilih **API by Zapier**, peristiwa **API Request**, dan koneksi.

- **Method**: `POST`.
- **URL**:

  ```
  https://api.astroway.info/v1/chart
  ```

- **Body**: JSON di bawah ini dengan kolom trigger menggantikan nilai.

```json
{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": "50.45",
  "longitude": "30.52"
}
```

Ganti setiap nilai dengan kolom trigger yang sesuai dan tanda kutip di sekitarnya, termasuk angka. Zapier menyisipkan kolom yang dipetakan sebagai teks biasa dan tidak menambahkan tanda kutip, sementara API menerima `"50.45"` sebagai angka. Jangan menambahkan kunci di Header langkah: koneksi yang menyediakan.

Uji langkah. Respons yang benar dimulai dengan `"ok": true`, dan `data.input.timezoneOffset` untuk contohnya sama dengan `4`: offset yang dimiliki Kyiv pada hari itu.

## 3. Ubah Ascendant menjadi zodiak

Dua langkah Formatter.

**Formatter, peristiwa Numbers, konversi Rumus Spreadsheet-Style.** Rumus:

```
FLOOR(ASCENDANT / 30)
```

di mana `ASCENDANT` diganti dengan `data.houses.ascendant` dari langkah 2. Untuk contoh, hasilnya adalah `5`.

**Formatter, peristiwa Utilities, konversi Lookup Table.** Lookup Key adalah hasil rumus. Tabel:

| Kunci | Nilai |
|---|---|
| 0 | Aries |
| 1 | Taurus |
| 2 | Gemini |
| 3 | Cancer |
| 4 | Leo |
| 5 | Virgo |
| 6 | Libra |
| 7 | Scorpio |
| 8 | Sagittarius |
| 9 | Capricorn |
| 10 | Aquarius |
| 11 | Pisces |

Untuk contoh, hasilnya adalah `Virgo`. Untuk mendapatkan nama dalam bahasa Indonesia, tulisnya di kolom Nilai.

Matahari dan Bulan dihitung dengan cara yang sama. Ini adalah entri pertama dan kedua dalam `data.planets`, masing-masing memiliki `longitude`: contohnya 54.34 (Taurus) dan 296.39 (Capricorn).

## Jika Anda menggunakan Webhooks by Zapier

Berfungsi, tetapi kunci berada di langkah, bukan di koneksi. Untuk peta, pilih peristiwa **Custom Request**: ia mengirimkan field Data persis seperti yang dimasukkan, sehingga JSON di atas akan dikirim tanpa perubahan. Tetapkan **Method** `POST`, dan di **Headers** tambahkan `X-Api-Key` dengan kunci Anda, serta `Content-Type` dengan nilai `application/json`.

## Jika langkah gagal

- **`400 INVALID_FIELD` dengan `timezone` dalam `details`**: zona yang cocok kosong, ini merupakan singkatan seperti `EST` atau bukan nama zona.
- **`400` dengan `date` atau `time` dalam `details`**: format trigger bukan `YYYY-MM-DD` / `HH:MM:SS`; tambahkan langkah Formatter untuk tanggal sebelum memanggil.
- **`403 ENDPOINT_NOT_IN_SCOPE`**: dalam cakupan kunci tidak ada `chart`.
- **`429 KEY_BUDGET_EXHAUSTED`**: kunci telah menghabiskan anggotanya; tingkatkan di dasbor.

API tidak melakukan geokoding. Jika trigger hanya memiliki nama tempat, koordinat harus datang dari trigger itu sendiri atau dari layanan geokoding yang Anda miliki kuncinya.