Hesap Pazarı REST API

Hızlı Başlangıç

Kimlik Doğrulama

İki yol var: (1) oturum tokenı — e-posta + şifre ile alınır, 30 gün ömürlüdür ve /api/v1/auth/token ucuna saatte saniye başına kısıtlı (10 istek / 5 dakika) açıktır; (2) panel anahtarı — Hesabım → API Anahtarları sayfasından oluşturulur, 365 gün ömürlüdür ve yetki (ability) seçimi yapılabilir. İki anahtar tipi de aynı şekilde kullanılır.

curl -X POST https://hesap.tc/api/v1/auth/token \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'email=siz@ornek.com' \
  -d 'password=*****'

{
  "token": "hpr_7f3c9a2e51d8b0a4f6c2e9d1b3a5c7e9",
  "token_type": "Bearer",
  "expires_in": 2592000
}

Güvenlik: token düz metni yalnızca yanıtlama anında görünür; sunucuda yalnızca SHA-256 karması saklanır. Kaybederseniz panelden silip yenisini oluşturun.

Uç Noktalar

Aşağıdaki tabloda tüm uçlar listelenir. Bearer rozetli uçlar kimlik doğrulama gerektirir; Açık rozetli uç token istemez. Yetki gerektiren uçlar için ability etiketi belirtilmiştir.

Genel

{
  "data": [
    {
      "id": 1,
      "name": "Dijital Ürünler",
      "slug": "dijital-urunler",
      "icon": "bi-cloud",
      "children": [
        { "id": 2, "name": "Sosyal Medya", "slug": "sosyal-medya" }
      ]
    }
  ]
}

{
  "sandbox": false,
  "echo": { "ping": "1" },
  "ts": "2026-09-17T10:00:00+03:00"
}

İlanlar

{
  "data": [
    {
      "id": 42,
      "title": "Steam Cüzdan Kodu",
      "slug": "steam-cuzdan-kodu",
      "price": 250,
      "sale_price": null,
      "currency": "TRY",
      "views": 128,
      "sales": 7,
      "seller": { "username": "novamarket", "rating": 4.9 },
      "image": "https://hesap.tc/public/uploads/listings/..jpg",
      "url": "https://hesap.tc/ilan/steam-cuzdan-kodu"
    }
  ],
  "meta": { "total": 1, "page": 1, "per_page": 25, "total_pages": 1 }
}

Siparişler

{
  "data": [
    {
      "order_no": "HP-2026-000123",
      "status": "delivered",
      "total": 250,
      "currency": "TRY",
      "created_at": "2026-09-01 12:00:00"
    }
  ]
}

Satıcı & Yorumlar

Hesap & Anahtarlar

{
  "sandbox": false,
  "data": {
    "period_days": 30,
    "sales": 14,
    "revenue": 3480.5,
    "views": 1207
  }
}

Yetkiler (abilities)

Satıcı panelindeki API Anahtarları sayfasından oluşturduğunuz her anahtara izin kümesi seçebilirsiniz. Anahtar, bir yetkiye sahip değilse ilgili uç 403 döndürür. Genel uçlar (/me, /listings…) yalnızca geçerli token ister; yetki denetimi yapmaz.

Sandbox & Canlı Anahtar

Anahtarınızı sandbox modda oluşturabilirsiniz: sandbox anahtarıyla yapılan çağrılar gerçek verilerinizi kullanmaya devam eder ancak yanıt her zaman "sandbox": true bayrağı taşır; böylece entegrasyonunuzun hangi anahtarla konuştuğunu kesin olarak doğrulayabilirsiniz. Sandbox/canlı ayrımı veri izolasyonu değil etiketleme üzerinedir — zararsız bir test ucundan üretime güvenle geçersiniz.

Durum Kodları

Tam Örnekler

TOKEN=$(curl -s -X POST https://hesap.tc/api/v1/auth/token \
  -d 'email=siz@ornek.com' -d 'password=*****' | grep -o 'hpr_[a-f0-9]*')

curl https://hesap.tc/api/v1/listings?category=1&page=1 \
  -H "Authorization: Bearer $TOKEN"

$ch = curl_init('https://hesap.tc/api/v1/orders?role=seller');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $token],
]);
$resp = json_decode(curl_exec($ch), true);
foreach ($resp['data'] ?? [] as $order) {
    echo $order['order_no'] . ' — ' . $order['status'] . PHP_EOL;
}

const resp = await fetch('https://hesap.tc/api/v1/me/stats', {
  headers: { Authorization: `Bearer ${token}` },
});
const { data } = await resp.json();
console.log(`${data.sales} satış / ₺${data.revenue}`);