Geliştirici API
Panelinizi API ile otomatikleştirin
Servisleri listele, bakiyeni sorgula, sipariş oluştur ve durumları kendi sisteminden takip et. Sade HTTP istekleri ve JSON cevaplarıyla hızlı entegrasyon kur.
API anahtarı Idempotency desteği JSON yanıtlar
4Temel işlem
GET / POSTİstek desteği
Tek endpointBakiye, servis, sipariş ve durum işlemleri
Bakiye sorgulaMevcut bakiyeyi uygulamandan kontrol et.
Servisleri senkronlaAktif servis kataloğunu otomatik çek.
Sipariş oluşturIdempotency anahtarıyla güvenli istek gönder.
Durum takip etSiparişin güncel durumunu sorgula.
1API anahtarını oluştur
Hesabındaki profil alanından API anahtarını oluştur ve güvenli biçimde sakla.
2Servisleri senkronla
action=services ile servis ID, fiyat ve limit bilgilerini kendi sistemine aktar.
3Sipariş göndermeye başla
action=add isteğini benzersiz idempotency anahtarıyla gönder ve sonucu takip et.
Base URL
https://www.manasgaming.com/api/myservices.php
GET POST Her iki HTTP metodu da desteklenir.
Kimlik Doğrulama
Tüm isteklerde key parametresi zorunludur.
| Parametre | Tip | Açıklama |
|---|---|---|
key |
string | Profilinizden aldığınız API anahtarı (zorunlu) |
Endpoints
action=balance
Hesap bakiyesini sorgular.
X-API-KeyHTTP başlığında API anahtarıactionbalance
action=services
Tüm aktif servisleri listeler.
X-API-KeyHTTP başlığında API anahtarıactionservices
action=add
Yeni sipariş oluşturur.
X-API-KeyHTTP başlığında API anahtarıactionaddserviceServis IDlinkHedef URLquantityMiktar
action=status
Sipariş durumunu sorgular.
X-API-KeyHTTP başlığında API anahtarıactionstatusorderSipariş ID
Örnek İstekler
1. Bakiye Sorgulama:
curl -H "X-API-Key: API_KEY" "https://www.manasgaming.com/api/myservices.php?action=balance"
2. Servis Listesi:
curl -H "X-API-Key: API_KEY" "https://www.manasgaming.com/api/myservices.php?action=services"
3. Sipariş Oluşturma:
curl -X POST "https://www.manasgaming.com/api/myservices.php" \
-H "X-API-Key: API_KEY" \
-H "X-Idempotency-Key: benzersiz-istek-123" \
-d "action=add" \
-d "service=1" \
-d "link=https://instagram.com/kullanici" \
-d "quantity=1000"
4. Sipariş Durumu:
curl -H "X-API-Key: API_KEY" "https://www.manasgaming.com/api/myservices.php?action=status&order=12345"
PHP Örneği
<?php
$apiUrl = "https://www.manasgaming.com/api/myservices.php";
$apiKey = "API_KEY";
function apiRequest($url, $key, $params, $idempotencyKey = null) {
$ch = curl_init($url);
$headers = ["X-API-Key: " . $key];
if ($idempotencyKey) {
$headers[] = "X-Idempotency-Key: " . $idempotencyKey;
}
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
$response = curl_exec($ch);
curl_close($ch);
return json_decode($response, true);
}
$balance = apiRequest($apiUrl, $apiKey, ["action" => "balance"]);
$services = apiRequest($apiUrl, $apiKey, ["action" => "services"]);
$order = apiRequest($apiUrl, $apiKey, [
"action" => "add",
"service" => 1,
"link" => "https://instagram.com/kullanici",
"quantity" => 1000
], bin2hex(random_bytes(16)));
print_r($balance);
print_r($services);
print_r($order);
?>
Dönüş Yapıları
action=balance
{
"balance": "125.50",
"currency": "TRY"
}
action=services
[
{
"service": "1",
"name": "Instagram Takipçi [TRY]",
"type": "default",
"category": "Instagram",
"rate": "45.00",
"min": "100",
"max": "10000",
"dripfeed": false,
"refill": false,
"cancel": true
}
]
action=add (Başarılı)
{
"order": 12345
}
action=status
{
"status": "pending",
"start_count": "0",
"remains": "1000",
"currency": "TRY"
}
Sipariş Durumları
| Durum | Açıklama |
|---|---|
pending |
Sipariş beklemede |
in_progress |
Sipariş işleniyor |
completed |
Sipariş tamamlandı |
partial |
Kısmi tamamlandı |
canceled |
Sipariş iptal edildi |
refunded |
İade edildi |
Hata Mesajları
| Hata | Açıklama |
|---|---|
API Key is missing |
API anahtarı gönderilmedi |
Invalid API Key |
Geçersiz veya pasif API anahtarı |
Invalid action |
Geçersiz action parametresi |
Missing parameters |
Zorunlu parametreler eksik |
Service ID not found |
Servis bulunamadı veya pasif |
Quantity below minimum |
Miktar minimum limitin altında |
Quantity above maximum |
Miktar maksimum limitin üstünde |
Not enough funds |
Yetersiz bakiye |
Order not found |
Sipariş bulunamadı |
System error |
Sistem hatası oluştu |
Hata Dönüş Örneği
{
"error": "Not enough funds"
}
Hata durumunda response içinde error anahtarı bulunur. Bu anahtarın varlığını kontrol ederek hata yönetimi yapabilirsiniz.
Önemli Notlar
- Tüm fiyatlar TRY (Türk Lirası) cinsindendir.
-
ratedeğeri 1000 adet için fiyatı gösterir. - Sipariş ücreti:
(quantity / 1000) × rateformülü ile hesaplanır. - API anahtarınızı kimseyle paylaşmayın.
- Aşırı istek gönderimi hesabınızın askıya alınmasına neden olabilir.