Kimlik doğrulama
Her istek bir API anahtarı gerektirir. Anahtar, Authorization başlığında Bearer olarak ya da X-API-Key başlığında gönderilir. Anahtarlar hesabınızdan üretilir; sır yalnızca üretim anında bir kez gösterilir.
curl https://isfarsiv.org/api/v1/assets?q=kupa \ -H "Authorization: Bearer isf_live_..."
Hesap → API anahtarları bölümünden anahtar üretin →
Ücretlendirme: yalnızca kredi
API üzerinden kart ödemesi yoktur; tek ödeme aracı hesabınızdaki kredi bakiyesidir.
- Kredi bakiyesi web arayüzünden yüklenir (paket ya da abonelik); API yalnızca bakiyeden düşer.
- Satın alma ucu "purchase" kapsamı ister; bu kapsam anahtar üretilirken açıkça seçilir ve varsayılan değildir.
- Fiyat, KDV ve kredi maliyeti her zaman sunucuda hesaplanır; fatura bilgisi hesabınızda kayıtlı profilden okunur.
Oran sınırı
Anahtar başına dakikada 60 istek garanti edilir: bu hızın altında kalan istemciler sınıra takılmaz. Sınır sabit pencereyle ve süreç başına uygulandığı için pratikte kısa süreli patlamalar bu değerin üstüne çıkabilir — güvenmeyin, 60/dk'yı tavan kabul edin. Aşımda 429 ve kaç saniye bekleneceğini söyleyen Retry-After başlığı döner; beklenmeden yapılan istekler de sınırdan düşer.
Uçlar
| Yöntem | Yol | Açıklama |
|---|---|---|
| GET | /api/v1/me | Anahtar sahibi: e-posta, kredi bakiyesi, kapsamlar. |
| GET | /api/v1/assets | Katalog araması. Parametreler: q, year_from, year_to, license, country, page, per_page. |
| GET | /api/v1/assets/{id|code} | UUID ya da public kod (örn. 1959-FNB-022) ile tek eser. |
| GET | /api/v1/collections | Yayımlanmış koleksiyonlar. Parametreler: q, page, per_page. |
| GET | /api/v1/collections/{slug} | Slug ile tek koleksiyon. |
| GET | /api/v1/orders | Anahtar sahibinin sipariş geçmişi. |
| POST | /api/v1/licenses | Kredi bakiyesinden lisans satın alma (purchase kapsamı gerekir). Gövde: asset_id, license, format. |
| GET | /api/v1/licenses/{code}/download | Satın alınmış lisansın imzalı master indirme bağlantısı (süreli). |
| GET | /api/v1/verify/{code} | Sertifika kodu doğrulama; kişisel veri dönmez. |
Lisans satın alma akışı
Sipariş sunucuda fiyatlanır, kredi bakiyesinden düşülür ve lisans sertifikası anında üretilir. Hesapta kayıtlı fatura bilgisi yoksa uç 409 billing_required döner — web arayüzünden bir kez tamamlamak yeterlidir.
curl -X POST https://isfarsiv.org/api/v1/licenses \
-H "Authorization: Bearer isf_live_..." \
-H "Content-Type: application/json" \
-d '{"asset_id": "9b2e…", "license": "editorial"}'
# 201 → { "data": { "order_code": "ISF-ORD-…",
# "licenses": [{ "certificate_code": "ISF-CERT-…", … }] } }Hatalar { "error": { "code", "message" } } biçimindedir: 401 geçersiz anahtar, 403 eksik kapsam, 409 eksik fatura bilgisi, 429 oran sınırı.
Kurumsal erişim
Üniversite kütüphaneleri ve araştırma kurumları için abonelik temelli veritabanı erişimi planlanmaktadır. Toplu erişim, kota ve kurumsal lisanslama ihtiyaçlarınız için iletişim sayfasından bize ulaşın.