API documentation

Endpoint

All requests use HTTPS. The endpoint accepts POST (recommended) and GET.

POST https://sns-panel.com/api/v2
Content-Type: application/x-www-form-urlencoded

Authentication

Send your API key in the key parameter, or use the Authorization: Bearer header.

# option A: form parameter
curl -X POST https://sns-panel.com/api/v2 -d "key=YOUR_KEY" -d "action=balance"

# option B: bearer header
curl -X POST https://sns-panel.com/api/v2 \
  -H "Authorization: Bearer YOUR_KEY" \
  -d "action=balance"

Services list

Returns all active services with rates and limits.

action=services

// response
[
  {
    "service": 1,
    "name": "KakaoTalk Channel Friends",
    "category": "KakaoTalk Channel",
    "rate": "5.00",
    "min": 10,
    "max": 100000,
    "refill": false,
    "cancel": false
  }
]

Balance

action=balance

// response
{ "balance": "100.0000", "currency": "USD" }

Add order

Place a new order. The charge is deducted from your balance atomically.

action=add
service=1
link=https://pf.kakao.com/_xyz
quantity=500

// response
{ "order": 4218 }

// insufficient balance
{ "error": "Not enough funds on balance" }  HTTP 402

Order status

# single
action=status&order=4218

# multi (comma-separated)
action=status&orders=4218,4219,4220

// response
{
  "charge": "2.500000",
  "start_count": 0,
  "status": "In progress",
  "remains": 320,
  "currency": "USD"
}

Refill

action=refill&order=4218
// { "refill": 42 }

action=refill_status&refill=42
// { "status": "pending" }

Cancel

action=cancel&orders=4218,4219
// {
  "4218": { "cancel": "requested" },
  "4219": { "error": "Cannot cancel" }
}

Errors