SMM + REST
Yaygın action tabanlı SMM entegrasyonlarının yanında modern JSON REST endpointleri.
Servis kataloğu, hesabına özel bayi fiyatı, sipariş oluşturma, durum takibi, bakiye, telafi, iptal ve HMAC imzalı webhook bildirimleri tek geliştirici altyapısında. Entegrasyonun yalnızca SosyalHawk servis ve sipariş kimlikleriyle çalışır.
POST https://sosyalhawk.com/api/v2
Authorization: Bearer sh_live_••••••••
action=add
service=128
link=https://...
quantity=1000
request_id=550e8400-e29b-41d4-a716-446655440000
{
"order": 8421,
"charge": "18.4000",
"status": "Pending"
}Yaygın action tabanlı SMM entegrasyonlarının yanında modern JSON REST endpointleri.
Anahtarı yalnızca belirlediğin IPv4/IPv6 sunucularından kullanılabilir hale getir.
Durum değişikliklerini HMAC-SHA256 imzası ve otomatik retry ile kendi paneline taşı.
Bayi seviyen ve varsa servis bazlı özel fiyatın API kataloğuna otomatik uygulanır.
API erişimi onaylı partner hesaplarına açılır. Önce API / Bayi Merkezi'nden erişim talebi gönderirsin; onaylandıktan sonra API anahtarını kendin oluşturursun ve tam anahtar yalnızca oluşturulduğu anda gösterilir. Anahtarı tarayıcı koduna veya herkese açık repoya koyma.
Tercih edilen yöntem Authorization: Bearer veya X-API-Key header'ıdır. SMM uyumluluğu için form içindeki key alanı da desteklenir.
Authorization: Bearer sh_live_...
X-API-Key: sh_live_...
API hesabın son 30 günlük gerçek API sipariş hacmine göre otomatik seviyelenir. Seviye yükseldiğinde indirim sonraki API fiyatlarına uygulanır; services yanıtındaki rate hesabına uygulanmış nihai TRY fiyatıdır.
Yüksek hacimli veya özel anlaşmalı hesaplarda hesap bazlı özel indirim ve servis bazlı özel API fiyatı tanımlanabilir.
https://sosyalhawk.com/api/v2application/x-www-form-urlencoded| action | Alanlar | Sonuç |
|---|---|---|
services | key | Servis kataloğu ve hesabına özel TRY fiyatı |
add | service, link/target, quantity, request_id? | Yerel SosyalHawk sipariş numarası |
status | order veya orders | Tek/bulk sipariş durumu |
balance | key | Mevcut TRY bakiye |
refill | order | Uygun sipariş için telafi talebi |
refill_status | refill | Telafi talebi durumu |
cancel | order | Uygun sipariş için iptal talebi |
curl -X POST 'https://sosyalhawk.com/api/v2' \ -H 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'key=sh_live_...' \ --data-urlencode 'action=services'
curl -X POST 'https://sosyalhawk.com/api/v2' \ -H 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'key=sh_live_...' \ --data-urlencode 'action=add' \ --data-urlencode 'service=128' \ --data-urlencode 'link=https://example.com/post' \ --data-urlencode 'quantity=1000'
/api/v2/servicesKatalog + bayi fiyatı/api/v2/balanceTRY bakiye/api/v2/ordersYeni sipariş/api/v2/orders/:idSipariş durumu/api/v2/orders/:id/refillTelafi/api/v2/refills/:idTelafi durumu/api/v2/orders/:id/cancelİptal talebiconst response = await fetch('https://sosyalhawk.com/api/v2/orders', {
method: 'POST',
headers: {
'Authorization': 'Bearer sh_live_...',
'Content-Type': 'application/json'
},
body: JSON.stringify({
service: 128,
link: 'https://example.com/post',
quantity: 1000,
request_id: crypto.randomUUID()
})
});
const data = await response.json();| Alan | Gerekli | Açıklama |
|---|---|---|
service | Evet | services yanıtındaki SosyalHawk servis ID'si. |
link / target | Servise göre | Gönderinin/profilin hedef adresi veya servis hedefi. |
quantity | Servise göre | Servisin min/max aralığında adet. |
request_id | Önerilir | UUID. Retry durumunda aynı UUID aynı siparişi ikinci kez oluşturmaz. |
order_fields | Gelişmiş servislerde | JSON nesnesi. Yorum, kullanıcı adı, abonelik vb. servis özel alanları. |
Gelişmiş servislerde comments, usernames, username, posts, runs, interval, min, max gibi desteklenen alanlar doğrudan veya order_fields içinde gönderilebilir. Zorunlu alanlar servis tipine göre doğrulanır.
Sipariş verirken RFC uyumlu UUID biçiminde request_id göndermen önerilir. Ağ timeout'u sonrasında aynı isteği aynı request_id ile tekrar gönderirsen sistem mevcut yerel siparişi döndürür; ikinci kez bakiye kesmez.
request_id kullan.API Merkezi'nden HTTPS webhook adresini kaydet, imza anahtarını bir kez kopyala ve istersen Test Webhooku Gönder ile bağlantını doğrula. Sipariş durum olayları order.updated olarak gönderilir.
X-SosyalHawk-Event | order.updated veya webhook.test |
X-SosyalHawk-Signature | sha256=<hex> |
import crypto from 'node:crypto';
const expected = 'sha256=' + crypto
.createHmac('sha256', process.env.SOSYALHAWK_WEBHOOK_SECRET)
.update(rawRequestBody)
.digest('hex');
const actual = req.headers['x-sosyalhawk-signature'] || '';
const valid = actual.length === expected.length && crypto.timingSafeEqual(
Buffer.from(expected),
Buffer.from(actual)
);Webhook yalnızca HTTPS public hedeflere gider. Local/private ağ adresleri reddedilir, DNS hedefi doğrulanıp bağlantı sırasında aynı public IP'ye pinlenir, redirect takip edilmez. Başarısız teslimatlar artan aralıklarla en fazla 5 kez tekrar denenir.
| Kod | Anlamı |
|---|---|
invalid_key | Anahtar geçersiz veya API erişimi kapalı. |
ip_not_allowed | İstek IP whitelist içinde değil. |
rate_limit | Anahtarın dakika limiti aşıldı. |
insufficient_balance | Hesap bakiyesi sipariş için yetersiz. |
service_not_found | SosyalHawk servis ID'si bulunamadı. |
request_id_invalid | request_id geçerli UUID formatında değil. |
refill_not_available | Sipariş telafi koşullarını karşılamıyor. |
cancel_not_available | Sipariş iptal için uygun değil. |
order_submission_uncertain | Gönderim sonucu doğrulanıyor; aynı işi farklı request_id ile tekrar yollama. |
Public durum ekranındaki 24 saatlik API metrikleri gerçek istek günlüklerinden hesaplanır; doğrulanmamış “%99.99 uptime” veya yapay işlem sayıları gösterilmez.