Sık sorulan sorular

Bir çağrı ne kadar tutar?

Ne kadar veri döndürürse döndürsün, başarılı her çağrı bir kredidir. İstisnalar PDF raporu ve yapay zekâ sohbeti endpoint'leridir: çağrı başına 25 kredi. Tek hesaplama isteyen bir istekle kırk hesaplama isteyen bir istek aynı tutar, çünkü birçok endpoint bir `keys` dizisi alır ve bir istekteki tüm anahtarlar o tek krediyle karşılanır.

Başarısız isteklerden ücret alınır mı?

Hayır. Occult API başarısız bir istekten asla ücret almaz. Kredi, hesaplama başlamadan önce ayrılır ve sorunsuz bir sonuç dönmezse iade edilir. Yani 4xx, 5xx ya da zaman aşımı hiçbir şeye mal olmaz; hatalı bir entegrasyon, siz hatasını ayıklarken bakiyenizi eritemez. Her yanıt, gerçekte ne kadar tuttuğunu X-Credits-Charged başlığında bildirir.

Kredilerin süresi dolar mı?

Bir planın kotası her ay sıfırlanır. Occult API aylık ya da yıllık planlarla satılır: her ay yeni bir kota gelir ve bir ay içinde kullanmadığınız çağrılar sonraki aya devretmez. Yıllık planlar da aynı şekilde çalışır: tek seferde faturalanan on iki aylık kota.

Ücretsiz bir seçenek var mı?

Yeni hesaplara ücretsiz kredi tanımlanır. Bu krediler, kendi verisi olan bir sandbox'ta değil, gerçek bir anahtarla canlı API'de harcanabilir. Ayrıca occultapi.com/playground adresindeki playground, kendi anahtarınızla çalışan API'ye gerçek çağrılar yapar; orada başarısız olan bir çağrı da ücretsizdir.

Abonelik var mı?

Evet. Occult API, siz iptal edene kadar otomatik olarak yenilenen aylık ya da yıllık planlarla satılır. İptal etmek bir sonraki yenilemeyi durdurur; mevcut dönem bitene kadar kullanılabilir kalır. Hiçbir kademe bir endpoint'i kilitlemez; her plan her endpoint'i çağırabilir.

402 hatası alıyorum. Anahtarım mı yanlış?

Hayır. insufficient_credits mesajlı bir 402, API anahtarının geçerli olduğunu ama kotanın dolduğunu gösterir. Anahtarı yeniden oluşturmak işe yaramaz; planı yükseltin ya da aylık sıfırlamayı bekleyin. Anahtarın kendisinde sorun olduğunu yalnızca 401 invalid_api_key gösterir.

API anahtarını tarayıcıda ya da mobil uygulamada kullanabilir miyim?

Hayır. Occult API anahtarı sunucu tarafında saklanması gereken bir sırdır. Ön yüz JavaScript'ine ya da bir mobil uygulama paketine konan anahtarı, uygulamayı yükleyen ya da geliştirici araçlarını açan herkes okuyabilir ve bakiyenizi harcayabilir. API'yi kendi sunucunuzdan çağırın, istemciye de kendi endpoint'inizi açın.

Anahtarımı kaybettim. Tekrar gönderebilir misiniz?

Hayır, bu bilinçli bir tercih. Occult API anahtarları yalnızca SHA-256 özeti olarak saklar; ne bir yönetici ne de bir veritabanı dökümü anahtarı geri getirebilir. Yeni bir anahtar oluşturup eskisini iptal edin. İptal anında geçerli olur ve kredi bakiyenizi etkilemez.

Bir anahtar sızarsa ne olur?

Anahtarlar sayfasından iptal edin; iptal anında geçerli olur. Her anahtarın herkese açık, sekiz karakterlik bir ön eki vardır. Bu ön ek tam da bu amaçla indekslenir: herkese açık bir depoya sızan bir anahtar, gizli kısmına kimsenin ihtiyacı olmadan yalnızca bu ön ekle bulunup iptal edilebilir.

Hesaplamalar neye dayanıyor?

Occult API, hesaplamalarını NASA JPL efemeris verileriyle yapar: 735 sabit yıldızı içeren veri setinin tamamı, MS 500 ile 2999 arası. Hiçbir değer önceden hesaplanmış bir almanak tablosundan okunmaz; her yanıt, istekteki tam an ve koordinatlar için hesaplanır.

Sonucunuz başka bir kaynakla uyuşmuyor. Neden?

Genellikle sebep ayanamsadır. Hint gelenekleri bu konuda gerçekten ayrışır ve bir derecelik fark bir gezegeni bir nakshatra sınırının öbür tarafına geçirebilir. Occult API 48 ayanamsa sunar ve her birini derece, dakika ve saniye düzeyinde düzeltmenize izin verir. İlk kontrol etmeniz gereken, iki kaynağın da aynı ayanamsayı kullanıp kullanmadığıdır.

Ne kadar hızlı?

Sunucu tarafında medyan yanıt süresi 62 ms. Bu değer seçilmiş tek bir örnekten değil, yayımlanan tüm örneklerden ölçüldü. Az sayıda endpoint derin tarama yapar (tam bir varshaphal taraması ya da bir yıllık raasi dasha gibi) ve saniyeler sürer. Bunlar medyanın arkasına saklanmaz, referansta açıkça belirtilir.

OpenAPI tanımı ya da SDK var mı?

Occult API, occultapi.com/openapi.json adresinde bir OpenAPI 3.1 belgesi yayımlar. Belge, dokümantasyonla aynı katalogdan üretilir ve her işlem için bir örnek içerir: 299 işlemden 255 tanesinin örneği canlı sunucudan alındı, gerisininki istek şemasından türetildi. openapi-generator ya da benzeri bir araçla istediğiniz dilde tipli bir istemci üretebilirsiniz. Ayrıca bir Postman koleksiyonu ve yapay zekâ asistanları için bir MCP sunucusu da var.

Bir yapay zekâ asistanı API'yi çağırabilir mi?

Evet. Occult API, tüm endpoint'leri beş araçla sunan bir MCP sunucusu yayımlar. Bu sunucu üzerinden endpoint aramak ve istek şemalarını okumak kredi harcamaz, yalnızca gerçek bir hesaplama harcar. Böylece bir asistan hiçbir şey harcamadan önce API'nin tamamını keşfedebilir. Kodlama ajanları için bir özet de occultapi.com/AGENTS.md adresinde yayında.

API'nin döndürdüğü verileri satabilir miyim?

Evet. Occult API, verileri kendi ürünlerinizde ticari olarak kullanmanız için telifsiz bir lisans verir: yanıtları kendi veritabanınızda saklamak, rapor üretip satmak ve müşteri işlerinde kullanmak da buna dahildir. Kaynak göstermeniz gerekmez. İzin verilmeyen tek şey, API erişiminin kendisini bir API olarak yeniden satmaktır.

Gönderdiğim doğum bilgilerini saklıyor musunuz?

Hayır. İstekteki tarih, saat ve yer yanıtı hesaplamak için kullanılır, sonrasında hiçbir veritabanına yazılmaz. Her çağrı için saklanan bilgiler endpoint, zaman damgası, HTTP durum kodu ve harcanan kredidir; kullanım raporları ve faturalama soruları için gereken de bunlardır.

DPA sunuyor musunuz?

Evet. Occult API, GDPR'ın 28. maddesini kapsayan bir Veri İşleme Sözleşmesi (DPA) yayımlar. Bunun yanında müşteri verilerine erişebilecek her üçüncü tarafın adını veren güncel bir alt işleyen listesi de yayındadır.

Sorunuz burada yoksa mridul.kabra23@gmail.com adresine yazın. Neleri ölçtüğümüzü ve neleri ölçmediğimizi yöntem sayfasında, neleri sakladığımızı ve neleri geliştirmediğimizi şeffaflık sayfasında bulabilirsiniz. Hata kodlarının tam listesi kimlik doğrulama bölümünde; 402 hatasının neden bir kimlik doğrulama hatası olmadığı da orada anlatılıyor.