Tài liệu API v2 cho đại lý

POST https://ducksmm.devlor.tech/api/v2

[
  {
    "service": 101,
    "id": 101,
    "name": "Tăng like bài viết Facebook - Server 1",
    "type": "Default",
    "category": "Facebook - Like",
    "rate": "20000.00",
    "currency": "VND",
    "price_unit": "per_1000",
    "min": "100",
    "max": "50000",
    "step": "1",
    "refill": true,
    "cancel": true
  }
]

{
  "order": 10245,
  "order_code": "ORDER_20261107_A1B2C3D4E5",
  "status": "Pending",
  "charge": "20000.00",
  "currency": "VND"
}

{
  "charge": "20000.00",
  "start_count": "1230",
  "status": "In progress",
  "remains": "600",
  "currency": "VND"
}

{
  "10245": {
    "charge": "20000.00",
    "start_count": "1230",
    "status": "Completed",
    "remains": "0",
    "currency": "VND"
  },
  "99999": { "error": "Incorrect order ID" }
}

{ "order": 10245, "refill": "cmabc123" }

[
  { "order": 10245, "refill": "cmabc123" },
  { "order": 99999, "refill": { "error": "Incorrect order ID" } }
]

{ "status": "In progress" }

[
  { "refill": "cmabc123", "status": "Completed" },
  { "refill": "cmabc456", "status": { "error": "Refill not found" } }
]

{ "order": 10245, "cancel": 1 }

[
  { "order": 10245, "cancel": 1 },
  { "order": 99999, "cancel": { "error": "Incorrect order ID" } }
]

{ "balance": "1250000", "currency": "VND" }

# Lấy danh sách dịch vụ
curl -X POST https://ducksmm.devlor.tech/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services

# Đặt đơn (gửi kèm idempotency_key để gửi lại an toàn)
curl -X POST https://ducksmm.devlor.tech/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=101 \
  --data-urlencode "link=https://www.facebook.com/yourpage" \
  -d quantity=1000 \
  -d idempotency_key=my-order-0001

# Gửi JSON cũng được
curl -X POST https://ducksmm.devlor.tech/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"balance"}'

<?php
function duck_api(array $params) {
    $ch = curl_init('https://ducksmm.devlor.tech/api/v2');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query(
            array_merge(['key' => getenv('DUCK_API_KEY')], $params)
        ),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 30,
    ]);
    $body = curl_exec($ch);
    curl_close($ch);
    $data = json_decode($body, true);
    if (isset($data['error'])) {
        throw new RuntimeException($data['error']);
    }
    return $data;
}

$order = duck_api([
    'action' => 'add',
    'service' => 101,
    'link' => 'https://www.facebook.com/yourpage',
    'quantity' => 1000,
    'idempotency_key' => 'my-order-0001',
]);
echo $order['order'];

import os
import requests

URL = "https://ducksmm.devlor.tech/api/v2"
KEY = os.environ["DUCK_API_KEY"]


def duck_api(**params):
    res = requests.post(URL, data={"key": KEY, **params}, timeout=30)
    data = res.json()
    if isinstance(data, dict) and "error" in data:
        raise RuntimeError(f"{res.status_code}: {data['error']}")
    return data


order = duck_api(
    action="add",
    service=101,
    link="https://www.facebook.com/yourpage",
    quantity=1000,
    idempotency_key="my-order-0001",
)
print(duck_api(action="status", order=order["order"]))