REST API rehberi

Genel dokümantasyon. Örneklerde yer tutucu anahtar kullanılır; çalıştırmak için giriş yapıp /api sayfasını açın veya Profildeki anahtarı elle yapıştırın.

Tüm uçlar JSON döner. Kimlik için yalnızca Profildeki anahtar (ifw_…) kullanılır — e-posta/şifre veya panel JWT’si REST isteklerinde geçerli değildir.

1. Kimlik doğrulama (her istekte)

Aşağıdaki HTTP başlıklarından birini ekleyin:

Başlık	Örnek değer	Not
X-Api-Key	ifw_PROFIL_SAYFANIZDAN_ANAHTARI_KOPYALAYIN	Önerilen yöntem.
Authorization	Bearer ifw_PROFIL_SAYFANIZDAN_ANAHTARI_KOPYALAYIN	Sadece `ifw_` ile başlayan anahtar.

2. GET /api/v1/me — Hesap ve özet

Gövde ve sorgu parametresi yok. Yanıt: user (id, email, balance, referral_code) ve stats (toplam link, aktif/tamamlanan görev sayıları).

curl -s "https://indexle.com.tr/api/v1/me" \
  -H "X-Api-Key: ifw_PROFIL_SAYFANIZDAN_ANAHTARI_KOPYALAYIN"

3. GET /api/v1/tasks — Görev listesi

Sorgu parametreleri (hepsi isteğe bağlı):

page — Sayfa, varsayılan 1
limit — Sayfa başına kayıt, varsayılan 20, en fazla 100
q — Görev id veya harici external_task_id içinde arama

Yanıt: data (görev dizisi) + meta (total, page, limit, pages).

curl -s "https://indexle.com.tr/api/v1/tasks?page=1&limit=10&q=" \
  -H "X-Api-Key: ifw_PROFIL_SAYFANIZDAN_ANAHTARI_KOPYALAYIN"

4. POST /api/v1/tasks — Yeni görev

Content-Type: application/json zorunlu. Gövde alanları:

Alan	Zorunlu	Açıklama
links	En az `links` veya `links_text` biri	URL dizisi, örn. `["https://site.com/sayfa"]`
links_text	↑	Çok satırlı metin; satır veya boşlukla ayrılmış URL’ler
searchengine	Hayır	`google` veya `bing` (varsayılan google)
mode	Hayır	`normal` = 1 kredi/URL, `hard` = 2 kredi/URL

curl -s -X POST "https://indexle.com.tr/api/v1/tasks" \
  -H "X-Api-Key: ifw_PROFIL_SAYFANIZDAN_ANAHTARI_KOPYALAYIN" \
  -H "Content-Type: application/json" \
  -d "{\"links\":[\"https://ornek.com/blog/yazi\"],\"searchengine\":\"google\",\"mode\":\"normal\"}"

5. GET /api/v1/tasks/{id} — Tek görev

{id} yolu, listedeki görev id (UUID) değeridir. Size ait değilse 404.

curl -s "https://indexle.com.tr/api/v1/tasks/GOREV_UUID_BURAYA" \
  -H "X-Api-Key: ifw_PROFIL_SAYFANIZDAN_ANAHTARI_KOPYALAYIN"

Taban URL ve şema

İsteklerin kök adresi (üretimde Yönetim → Genel site URL ile aynı olmalı):

https://indexle.com.tr

OpenAPI JSON: https://indexle.com.tr/api/openapi.json

Hata gövdesi: {"error":"kod","message":"açıklama"} — 401 yetkisiz, 400 doğrulama, 404 bulunamadı, 409 kredi/platform.

OpenAPI (Swagger UI)

Aşağıda etkileşimli deneme var. Authorize’a profil anahtarınızı yapıştırın.