# Zapier

Tetikleyiciden doğum tarihi, saati, zaman dilimi ve koordinatlarını alan bir Zap, API'den bir harita ister ve Yükselen'i bir burç adına dönüştürür. Aşağıdaki istek, adımın oluşturduğu şekilde üretime gönderilmiştir; Zapier'daki adımlar, 17.09.2026 tarihli Zapier belgelerine göre yazılmıştır.

<Aside type="caution" title="Ücretli Zapier Planı Gerekli">
API by Zapier, Webhooks by Zapier ve Formatter premium uygulamalardır. Zapier belgeleri, üçünün de Ücretsiz planda kullanılamadığını belirtir ve Lookup Table adımı Profesyonel veya daha yüksek bir plan gerektirir. Ücretsiz planda [Make](/integrations/make/) veya [n8n](/integrations/n8n/) kullanabilirsin.
</Aside>

Öncelikle, [Otomasyon Anahtarı](/integrations/#ключ-для-автоматизації) bölümünde açıklandığı gibi bir anahtar oluştur, `chart` kapsamıyla.

## 1. Anahtarı Bağlantıya Yerleştir

Webhooks by Zapier adımına girilen başlıklar adımın kendisinde saklanır ve Zap'a erişimi olan herkes tarafından görülebilir. API by Zapier bunları bağlantıda tutar.

1. **Uygulamalar** sayfasında **+ Bağlantı ekle**'ye tıkla ve **API by Zapier**'ı seç.
2. **Kimlik doğrulama türü**: Statik Başlıklar (API anahtarı).
3. **Başlıklar**: `X-Api-Key: ` ve ardından anahtarın, tek bir satırda.
4. **Alan adı filtresi**: `api.astroway.info`, böylece bağlantı başka bir yere yönlendirilemez.

## 2. Haritayı Çağır

Bir eylem ekle, **API by Zapier**'ı, **API İsteği** olayını ve bağlantıyı seç.

- **Yöntem**: `POST`.
- **URL**:

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

- **Gövde**: Değerler yerine tetikleyici alanlarını içeren aşağıdaki JSON.

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

Her değeri ilgili tetikleyici alanıyla değiştir ve sayılar dahil her birinin etrafındaki tırnak işaretlerini bırak. Zapier eşleştirilen alanı düz metin olarak ekler ve tırnak işaretlerini kendisi eklemez, ancak API `"50.45"`'i bir sayı olarak kabul eder. Anahtarı adımın Başlıklarına ekleme: bağlantı onu otomatik olarak ekleyecektir.

Adımı test et. Doğru yanıt `"ok": true` ile başlar ve örnek için `data.input.timezoneOffset` `4`'tür: o gün Kiev'in sahip olduğu ofset.

## 3. Yükselen'i Burca Dönüştür

İki Formatter adımı.

**Biçimlendirici, Sayılar olayı, Elektronik Tablo Stili Formülü dönüşümü.** Formül:

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

burada `ASCENDANT` yerine 2. adımdaki `data.houses.ascendant` yerleştirilmiştir. Örnek için sonuç `5`'tir.

**Biçimlendirici, Yardımcı Programlar olayı, Arama Tablosu dönüşümü.** Arama Anahtarı formülün sonucudur. Tablo:

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

Örnek için sonuç `Virgo`'dur. Ukraynaca isimleri almak için bunları Değer sütununa yaz.

Güneş ve Ay da aynı şekilde hesaplanır. Bunlar `data.planets` içindeki birinci ve ikinci kayıttır, her birinin kendi `longitude`'u vardır: örnek için 54.34 (Boğa) ve 296.39 (Oğlak).

## Webhooks by Zapier kullanıyorsan

Çalışır, ancak anahtar bağlantıda değil, adımda bulunur. Harita için **Özel İstek** olayını seç: bu, Veri alanını tam olarak girildiği gibi gönderir, bu nedenle yukarıdaki JSON değişmeden gider. **Yöntem**'i `POST` olarak ayarla ve **Başlıklar**'a hem anahtarınla birlikte `X-Api-Key`'i hem de `application/json` değeriyle `Content-Type`'ı ekle.

## Adım Başarısız Olduğunda

- **`details` içinde `timezone` ile `400 INVALID_FIELD`**: eşleştirilen zaman dilimi boş, `EST` gibi bir kısaltma veya bir zaman dilimi adı değil.
- **`details` içinde `date` veya `time` ile `400`**: tetikleyici formatı `YYYY-MM-DD` / `HH:MM:SS` değil; çağrıdan önce tarih için bir Formatter adımı ekle.
- **`403 ENDPOINT_NOT_IN_SCOPE`**: anahtarın kapsamı içinde `chart` yok.
- **`429 KEY_BUDGET_EXHAUSTED`**: anahtar kendi bütçesini tüketti; kontrol panelinde yükselt.

API coğrafi kodlama yapmaz. Eğer tetikleyici yalnızca bir yer adına sahipse, koordinatlar tetikleyicinin kendisinden veya anahtarın olduğu bir coğrafi kodlama hizmetinden gelmelidir.