API dokümantasyonu

Başlarken

API, panel hesabınıza bağlıdır: her satın alma sizin bakiyenizden düşer ve varsa size özel fiyatınız uygulanır. Kullanmak için:

Panele giriş yapın → Hesabım → API erişimi.
Bir anahtar oluşturun. Anahtarınızı aynı sayfadan istediğiniz zaman görüp kopyalayabilirsiniz.
Her istekte anahtarı başlıkta gönderin.
Bakiyeniz bittiğinde panelden bakiye yükleyin.

Ücretsiz hesap aç

Taban adres ve kimlik

Tüm uçlar bu adresin altındadır:

https://hesap.webfinity.com.tr/api/v1

Anahtarınızı Authorization başlığında gönderin (alternatif olarak X-API-Anahtar başlığı da kabul edilir):

Authorization: Bearer wfk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Tüm tutarlar kuruş cinsindendir: 4200 = 42,00 ₺. Yanıtlar JSON'dur.

Uç noktalar

Yöntem	Yol	Açıklama
GET	`/api/v1/urunler`	Ürünler, size özel fiyat ve hazır stok
GET	`/api/v1/bakiye`	Bakiyeniz ve hesap bilgisi
POST	`/api/v1/satin-al`	Satın alma; teslim edilen hesapları döner
GET	`/api/v1/siparis/:id`	Bir siparişin teslim hesaplarını tekrar getirir

Ürünler

curl https://hesap.webfinity.com.tr/api/v1/urunler \
  -H "Authorization: Bearer wfk_..."

{
  "urunler": [
    { "kod": "outlook", "ad": "Outlook Hesabı", "fiyat_kurus": 100, "stok": 42 }
  ]
}

Bakiye

curl https://hesap.webfinity.com.tr/api/v1/bakiye \
  -H "Authorization: Bearer wfk_..."

{ "uye_id": 12, "eposta": "bayi@site.com", "bakiye_kurus": 54000, "bayi": true }

Satın alma

Ürün kodu ve adet gönderin. İşlem atomiktir: stok ve bakiye yetiyorsa hesaplar teslim edilir ve tutar bakiyenizden düşer; yetmiyorsa hiçbir şey değişmez. Tek siparişte en çok 100 adet.

curl -X POST https://hesap.webfinity.com.tr/api/v1/satin-al \
  -H "Authorization: Bearer wfk_..." \
  -H "Content-Type: application/json" \
  -d '{"urun_kodu":"outlook","adet":2}'

{
  "durum": "tamam",
  "siparis_id": 1234,
  "urun": "Outlook Hesabı",
  "adet": 2,
  "toplam_kurus": 200,
  "kalan_bakiye_kurus": 53800,
  "hesaplar": [
    { "eposta": "ornek1@outlook.com", "sifre": "....", "ek_veri": null },
    { "eposta": "ornek2@outlook.com", "sifre": "....", "ek_veri": null }
  ]
}

Not: hesaplar listesi yalnızca bu yanıtta ve /api/v1/siparis/:id ucunda döner. Teslim bilgilerini kendi tarafınızda saklamanız önerilir.

Sipariş sorgulama

curl https://hesap.webfinity.com.tr/api/v1/siparis/1234 \
  -H "Authorization: Bearer wfk_..."

Yalnızca kendi siparişlerinizi görürsünüz.

Hata kodları

Hata yanıtları { "hata": "...", "kod": "..." } biçimindedir. Program akışınızda kod alanına göre karar verin (mesaj metni değişebilir).

kod	HTTP	Anlamı
`anahtar_yok`	401	Authorization / X-API-Anahtar başlığı eksik
`anahtar_gecersiz`	401	Anahtar hatalı veya iptal edilmiş
`hesap_pasif`	403	Hesabınız pasif, destek ile görüşün
`gecersiz_adet`	400	Adet 1..100 aralığında olmalı
`urun_yok`	404	Ürün bulunamadı veya satışta değil
`bakiye_yetersiz`	402	Bakiyeniz yetersiz (gereken_kurus döner)
`stok_yetersiz`	409	Hazır stok yetersiz (mevcut / istenen döner)
`siparis_yok`	404	Sipariş bulunamadı (veya size ait değil)
`hiz_siniri`	429	Çok fazla istek, Retry-After başlığına bakın
`mesgul`	503	Sistem anlık meşgul, tekrar deneyebilirsiniz
`sunucu`	500	Beklenmeyen hata, işlem yapılmadı, tekrar deneyin

Sınırlar

Dakikada anahtar başına ~120 istek. Aşılırsa 429 ve Retry-After döner.
Bir siparişte en çok 100 adet.
Kimlik hatalarında IP bazlı ek yavaşlatma uygulanır.

Sorularınız için iletişim sayfasından bize ulaşın.