# Kod olmadan entegrasyonlar

Bu sayfalardaki her şey 2026-09-17 tarihli prodüksiyona karşı yapılmıştır. n8n için workflow içe aktarıldı ve gerçek n8n'de çalıştırıldı; Zapier ve Make için adımlar bu araçların kendi dokümantasyonuna göre yazıldı ve oluşturdukları istekler tam da bu şekilde gönderiliyor.

## İstek nereden geliyor

Buna bağlı olarak hangi anahtarın gerektiği belirlenir.

- **Zapier, Make ve n8n** bunu kendi sunucularından gönderir. “Sadece sunucu” alanı ve bütçe ile bir anahtar gerekir, aşağıda açıklandığı gibi. Talimatlar: [Zapier](/integrations/zapier/), [Make](/integrations/make/), [n8n](/integrations/n8n/).
- **Bubble** da isteklerini kendi sunucularından gönderir ve anahtar başlıkta bulunur, orada kalır: [Bubble](/integrations/bubble/).
- **FlutterFlow** bir uygulamaya derlenir ve kullanıcıda kalır, bu yüzden çağrı özel olmalıdır: [FlutterFlow](/integrations/flutterflow/).
- **Wix, Squarespace, Shopify, Webflow ve Tilda** ziyaretçinin tarayıcısında sayfa gösterir. Anahtar yerine widget ekleyin: [site oluşturucular](/integrations/site-builders/).
- **WordPress** kendi sunucundan erişir. Anahtarı [AstroWay eklentisi](https://wordpress.org/plugins/astroway/) yönetir.

<Aside type="caution">
Public anahtar `pk_` Zapier, Make veya n8n ile çalışmaz. Origin olmadan gelen isteği kendi listesinden reddeder ve bu araçlar origin göndermez. Site sayfasından sadece `/v1/public/*` ve `/v1/embed/*` alır.
</Aside>

## Otomasyon için anahtar

Zap, senaryo veya workflow'u düzenleyebilen herkes anahtarı içinde görür. Bu yüzden her otomasyona kendi anahtarını ver ve ne yaptığını ona göre kısıtla.

1. Panoda [API-anahtarları](https://api.astroway.info/dashboard/keys) aç ve **Yeni anahtar**'a tıkla. Otomasyona göre adlandır, örneğin `zapier-intake-form`.
2. **Bu anahtar nerede kullanılacak?** alanında **Sadece sunucu**'yu bırak.
3. Anahtarı kopyala. Diyalog onu bir kez tamamen gösterir; daha sonra **Göster** menüsü üzerinden erişilebilir.
4. Anahtar menüsünde **Endpoint alanı**'nı aç ve otomasyonun çağırdığı yolları satır satır listele: `chart` natal harita için, `public/horoscope/*` günlük horoskoplar için.
5. Aynı menüde **Bütçe belirle**'yi aç ve bu anahtarın bir döngüde harcayabileceği kredi miktarını gir.

Liste dışı bir çağrı `403 ENDPOINT_NOT_IN_SCOPE` alır. Bütçesi tükenen anahtar `429 KEY_BUDGET_EXHAUSTED` alır, hatta hesabında kredi olsa bile, bu yüzden döngüye giren otomasyon belirtilen sayıda durur. Her iki sınırlama da tüm tarifelerde çalışır ve [Kimlik doğrulama](/authentication/) bölümünde açıklanmıştır.

## Doğum anını gönder, kaydırma değil

Form tarih, saat ve konum verir. Bunları şu şekilde gönder:

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

- **`timezone`** bölge adıdır ve sunucu UTC'ye göre kaydırmayı otomatik olarak bulur, o tarihteki saatler ve yaz saati dahil. Kiev 1990-05-15 tarihinde UTC+4'teydi, +3 değil: manuel girilen kaydırma bu hatayı verir. Bölgeyi koordinatlardan almak için `auto` gönder.
- **`timezone` ve kaydırma olmadan** harita UTC için hesaplanır. Yanıt yine `200` olur, bu yüzden alanın eşleştiğini kontrol et.
- **Boş `timezone`** `400` ile reddedilir, aksi takdirde boş form alanı UTC olarak okunurdu.
- **`date`** `YYYY-MM-DD` formatında, **`time`** `HH:MM:SS` formatında. Form farklı kaydediyorsa, tarih formatlamasını araç içinde kullan.
- **Sayısal değerler metin olarak gelebilir.** `"latitude": "50.45"` kabul edilir ve çoğu form alanı bunu bu şekilde gönderir.
- **API coğrafi kodlama yapmaz.** Koordinatlar formdan ya da araçta coğrafi kodlama adımından gelmelidir. `city` alanı sadece bir etiket.

1970 yılına kadar saat ve tarih dönüştürme kuralları [alan formatları](/agent-setup/field-formats/#timezone-назва-зони-замість-зсуву) bölümünde açıklanmıştır.

## Boylamları burçlara dönüştürme

`POST /v1/chart` zodyak boyunca derece cinsinden yanıt verir, `{ "ok": true, "data": { ... } }` kapsülünde. Burç `floor(longitude / 30)` ile, sıfırdan başlayarak hesaplanır:

0 Koç, 1 Boğa, 2 İkizler, 3 Yengeç, 4 Aslan, 5 Başak, 6 Terazi, 7 Akrep, 8 Yay, 9 Oğlak, 10 Kova, 11 Balık.

En popüler üç değer nerede bulunur:

- **Güneş**: `data.planets` içinde `"name": "Sun"` kaydı, birincisi.
- **Ay**: `data.planets` içinde `"name": "Moon"` kaydı, ikincisi.
- **Ascendant**: `data.houses.ascendant`.
- **Kullanılan kaydırma**: `data.input.timezoneOffset`.

Yukarıdaki örnek için: Güneş 54.34, yani Boğa; Ay 296.39, yani Oğlak; Ascendant 159.26, yani Başak; kaydırma 4.

## Maliyeti ne kadar

- `POST /v1/chart` 20 kredi maliyetindedir. Tam tablo [Endpoint maliyetleri](/credits/) sayfasında.
- Aynı istek beş dakika içinde tekrar gönderildiğinde önbellekten döner ve kredi harcanmaz. Tek bir gövdeyi tekrarlayan test çalışması bütçe harcamaz.
- `GET /v1/public/horoscope/daily` kredi harcamaz. Anahtar olmadan veya Free tarifesinde bir anahtarla IP adresinden saat başına 30 istek limiti uygulanır, otomasyon platformları adreslerini müşteriler arasında paylaşır. Ücretli tarifedeki anahtar kendi limitine sahiptir.