Admin API v2

Admin API, panelinizi kendi araçlarınızdan yönetmenizi sağlar: siparişleri çekip elle işlemek, kullanıcı açmak, bakiye yüklemek, ticket yanıtlamak. Uç noktalar ve yanıt zarfı Perfect Panel Admin API v2 ile uyumludur.

Anahtar

Anahtarlar portalda oluşturulur: my.followerhq.com → Panellerim → panel → Admin API. Her anahtarın:

• kendi yetki listesi vardır (yalnız sipariş okuma, yalnız ödeme ekleme gibi), "tam yetki" de seçilebilir;
• değeri yalnız bir kez gösterilir: kopyalayıp saklayın;
• son kullanım zamanı görünür; tek tıkla iptal edilir.

Bağlantı

Adres	https://<panel-alan-adı>/adminapi/v2/...
Kimlik	X-Api-Key: <anahtar> başlığı
Hız sınırı	panel başına 5 istek / saniye; aşımda HTTP 429
Gövde	JSON (Content-Type: application/json)

Yanıt zarfı

{ "data": { ... }, "error_message": "", "error_code": 0 }

Hata durumunda HTTP kodu ve error_code birlikte gelir:

HTTP	error_code	Anlam
401	401	Anahtar geçersiz
403	403	Anahtarın bu işlem için yetkisi yok
404	40	Nesne bulunamadı
429	429	Hız sınırı

Liste uç noktaları offset ve limit (varsayılan 100, en fazla 1.000) alır ve prev_page_href / next_page_href döner.

Uç noktalar

Siparişler

Yöntem	Yol	Ne yapar
GET	/orders	Liste (durum, kullanıcı, servis, tarih filtreleri)
GET	/orders/{order_id}	Tek sipariş
POST	/orders/pull	Manuel işlenecek bekleyen siparişleri kilitleyerek çeker
POST	/orders/update	Çekilen siparişlerin sayaç ve durumunu günceller
POST	/orders/change-status	Durum değiştirir
POST	/orders/cancel	İptal + iade
POST	/orders/{order_id}/set-partial	Kısmi tamamlanma; kalan bakiyeye iade
POST	/orders/{order_id}/edit-link	Bağlantıyı düzeltir
POST	/orders/resend	Sağlayıcıya yeniden gönderir
POST	/orders/request-cancel	Sağlayıcıya iptal isteği

pull → update çifti, sağlayıcı yerine kendi sisteminizle teslimat yaptığınız "manuel" servisler içindir: pull bir siparişi başka bir istemcinin aynı anda alamayacağı şekilde işaretler.

Refill ve iptal görevleri

POST /refill/pull, POST /refill/change-status, POST /cancel/pull, POST /cancel/reject

Kullanıcılar

GET /users, POST /users/add, POST /users/{user_id}/edit

E-posta, bakiye ve harcama alanları ayrı yetkilerle korunur; anahtarda o yetki yoksa alan yanıtta bulunmaz.

Ödemeler

GET /payments, POST /payments/add, manuel/bonus bakiye yüklemesi; kaydı Admin → Ödemeler'de görünür.

Destek talepleri

GET /tickets, GET /tickets/{ticket_id}, POST /tickets/{ticket_id}/reply, POST /tickets/add

Örnek

curl -X POST https://panel.ornek.com/adminapi/v2/payments/add \
  -H "X-Api-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"user_id": 42, "amount": "100.00", "method": "manual", "memo": "Havale 2026-09-15"}'

Tam referans

Her uç noktanın parametreleri ve yanıt şemaları, alan adınızla doldurulmuş olarak panelinizde:

• https://<panel-alan-adı>/admin/adminapi/v2, okunabilir referans
• https://<panel-alan-adı>/openapi/adminapi/v2/index.php. OpenAPI JSON (araçlara vermek için)