Hızlı başlangıç

Gerçek bir istek gönderin, gerçek yanıtı okuyun, sonra kodunuza bağlayın. Başarısız çağrı ücretsizdir.

1. Anahtar alın

Hesap oluşturun ve Anahtarlar sayfasından bir anahtar üretin. Yeni hesaplar 150 ücretsiz kredi ile başlar. Bu krediler, kendi verisi olan bir sandbox'ta değil, canlı bir anahtarla gerçek API'de harcanır.

Anahtar yalnızca bir kez gösterilir ve sadece hash olarak saklanır; bu yüzden onu sizin için geri getiremeyiz. Doğrudan gizli bilgi yöneticinize kaydedin. Kaybederseniz destek istemek yerine anahtarı yenileyin.

2. Playground'da deneyin

Playground'u açın, anahtarınızı yapıştırın, bir endpoint seçin ve gönderin. Playground, kendi anahtarınızla canlı API'ye gerçek çağrılar yapar; başarısız çağrı ücretsizdir. Kod yazmadan önce bunu yapın: birkaç saniye sürer ve yanıtta ürününüzün ihtiyaç duyduğu bilgilerin olup olmadığını gösterir.

3. Çağrıyı yapın

Tüm çağrılar JSON gövdeli birer POST isteğidir ve X-API-Key başlığıyla doğrulanır. Bu örnek, Jaipur için bugünün panchang'ını ister:

curl

curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date_time": "2026-09-16T06:00:00+05:30",
    "latitude": 26.9124,
    "longitude": 75.7873,
    "timezone_as_float": 5.5,
    "keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"]
  }'

TypeScript

const response = await fetch(
  "https://api.occultapi.com/api/astro/panchanga/",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.OCCULT_API_KEY!,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      date_time: "2026-09-16T06:00:00+05:30",
      latitude: 26.9124,
      longitude: 75.7873,
      timezone_as_float: 5.5,
      keys: ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"],
    }),
  },
);

const body = await response.json();
if (body.is_error) throw new Error(body.message);
console.log(body.data);

Python

import os, requests

response = requests.post(
    "https://api.occultapi.com/api/astro/panchanga/",
    headers={"X-API-Key": os.environ["OCCULT_API_KEY"]},
    json={
        "date_time": "2026-09-16T06:00:00+05:30",
        "latitude": 26.9124,
        "longitude": 75.7873,
        "timezone_as_float": 5.5,
        "keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"],
    },
)

body = response.json()
if body["is_error"]:
    raise RuntimeError(body["message"])
print(body["data"])

4. Yanıtı okuyun

Tüm yanıtlar aynı yapıyı kullanır. is_error değerine göre dallanın; sonuç data altında, istediğiniz anahtarların adıyla yer alır.

Yanıt

{
  "data": {
    "tithi": {
      "paksha": "Shukla",
      "name": "Panchami",
      "number": 5,
      "start_time": "2026-09-15T02:15:17Z",
      "end_time": "2026-09-16T03:30:28Z",
      "remaining_time": { "hours": 3, "minutes": 0, "seconds": 28 }
    },
    "nakshatra_segments": [
      { "name": "Vishakha", "start_time": "2026-09-15T09:51:13.999999Z", "end_time": "2026-09-16T11:52:46.999999Z" },
      { "name": "Anuradha", "start_time": "2026-09-16T11:52:46.999999Z", "end_time": "2026-09-17T14:23:53.999999Z" }
    ],
    "yogam": "Vaidhriti",
    "karana": "Balava",
    "vaara": "Mangalavara"
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Alanların yapısı endpoint'e göre değişir. Referanstaki endpoint sayfalarının çoğu uydurma değil, gerçek bir çağrıdan alınmış yanıt gösterir; henüz doğrulanmamış birkaç sayfa bunu açıkça belirtir.

5. Maliyeti kontrol edin

Yanıt başlıkları bunu söyler; ikinci bir çağrıya gerek yoktur:

X-Credits-Cost:      1
X-Credits-Charged:   1     # 0 on any error — you are billed for answers
X-Credits-Remaining: 149

Birden fazla istek göndermek yerine tek istekte birden fazla keys değeri isteyin. Fiyat her iki durumda da aynıdır; yani beş hesaplama için tek çağrı, beş ayrı çağrının beşte birine mal olur.

Altyapı kodunu yazmak istemiyor musunuz?

Bir yapay zekâ asistanını MCP sunucumuza bağlayın; endpoint'leri arayabilir, istek şemasını okuyabilir ve çağrıyı kendisi yapabilir. Arama yapmak ve dokümanları okumak kredi harcamaz. Bir kodlama ajanıyla çalışıyorsanız ona önce /agents sayfasını verin. Herhangi bir dilde tip güvenli bir istemci üretmek için OpenAPI tanımını kullanın.