API التوثيق

ادمج خدمات زيادات في تطبيقك عبر REST API. جميع الطلبات تستخدم POST وتُرجع استجابات JSON.

طريقة HTTP POST
رابط API https://zyadat.com/api/v2
صيغة الاستجابة JSON

قائمة الخدمات

المعاملات الوصف
key Your API key
action services

مثال على الاستجابة

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]

إضافة طلب

المعاملات الوصف
key Your API key
action add
service Service ID
link Link to page
quantity Needed quantity
runs (optional) Runs to deliver
interval (optional) Interval in minutes

مثال على الاستجابة

{
    "order": 23501
}

حالة الطلب

المعاملات الوصف
key Your API key
action status
order Order ID

مثال على الاستجابة

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

حالة طلبات متعددة

المعاملات الوصف
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

مثال على الاستجابة

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}

إنشاء إعادة تعبئة

المعاملات الوصف
key Your API key
action refill
order Order ID

مثال على الاستجابة

{
    "refill": "1"
}

إنشاء إعادة تعبئة متعددة

المعاملات الوصف
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

مثال على الاستجابة

[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": 2
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]

الحصول على حالة إعادة التعبئة

المعاملات الوصف
key Your API key
action refill_status
refill Refill ID

مثال على الاستجابة

{
    "status": "Completed"
}

الحصول على حالة إعادة تعبئة متعددة

المعاملات الوصف
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

مثال على الاستجابة

[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]

إنشاء إلغاء

المعاملات الوصف
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

مثال على الاستجابة

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]

رصيد المستخدم

المعاملات الوصف
key Your API key
action balance

مثال على الاستجابة

{
    "balance": "100.84292",
    "currency": "USD"
}

مثال على كود PHP

فتح مثال PHP