مستندات

جزئیات وبسرویس

متد POST
آدرس برای ارسال درخواست ها https://senatorgram.com/api/v1/
کلید دسترسی شما برای دریافت کلید دسترسی، باید در سایت ثبت نام کنید.
متد
POST
آدرس برای ارسال درخواست ها
https://senatorgram.com/api/v1/
کلید دسترسی شما
برای دریافت کلید دسترسی، باید در سایت ثبت نام کنید.

لیست محصولات

برای مشاهده لیست محصولات، باید یک درخواست که شامل پارامترهای زیر میباشد را به آدرس ذکر شده ارسال کنید.
نام پارامتر توضیحات
key کلید دسترسی
action services
description این پارامتر اختیاری است. در صورتی که میخواهید توضیحات محصولات را هم دریافت کنید، مقدار Yes را در این پارامتر ارسال کنید
در صورتی که درخواست به درستی ارسال شده باشد، اطلاعات محصولات سایت برگشت داده میشود. نمونه پاسخ:
[
    {
        "service":"1", // کد محصول
        "name":"فالوور اینستاگرام - سرور یک",
        "type":"default", // محصولات عادی سایت
        "category": "فالوور اینستاگرام"
        "rate":"2500", //قیمت هر هزار عدد بر حسب تومان
        "min":"500", //حداقل تعداد محصول
        "max":"2000" //حداکثر تعداد محصول
    },
    {
        "service":"2", // کد محصول
        "name":"کامنت اینستاگرام (متن سفارشی)",
        "type":"comments", // محصولاتی که فیلد "متن کامنت ها" را دارند.
        "category": "کامنت اینستاگرام"
        "rate":"2500", //قیمت هر هزار عدد بر حسب تومان
        "min":"500", //حداقل تعداد محصول
        "max":"2000" //حداکثر تعداد محصول
    },
]

ثبت سفارش جدید

برای ثبت سفارش جدید ، باید یک درخواست به آدرس ذکر شده در بالا ارسال کنید و داده های زیر را در درخواست خود استفاده کنید
نام پارامتر توضیحات
key کلید دسترسی
action add
service کد محصول که میتوانید از این صفحه پیدا کنید.
link لینک سفارش
quantity تعداد سفارش
در صورتی که درخواست به درستی ارسال شده باشد، سفارش ثبت شده و کد سفارش برگشت داده میشود. نمونه پاسخ:
{
    "order":"23501"
}

بررسی وضعیت یک سفارش

برای بررسی وضعیت یک سفارش، باید یک درخواست که شامل پارامترهای زیر میباشد را به آدرس ذکر شده ارسال کنید.
نام پارامتر توضیحات
key کلید دسترسی
action status
order کد سفارش
در صورتی که درخواست به درستی ارسال شده باشد، هزینه سفارش، شروع شمارنده، وضعیت، مقدار باقی مانده و واحد پولی برگشت داده میشود. نمونه پاسخ:
{
    "charge": "2000",
    "start_count": "324",
    "status": "Completed",
    "remains": "0",
    "currency": "Toman"
}

/*
    وضعیعت سفارش:
    1- Pending : در انتظار
    2- Inprogress : درحال انجام
    3- Processing : در حال ارسال
    4- Completed : انجام شده
    5- Canceled : لغو شده
    6- Partial : ناقص
*/
   

بررسی وضعیت چند سفارش

برای بررسی وضعیت چند سفارش، باید یک درخواست که شامل پارامترهای زیر میباشد را به آدرس ذکر شده ارسال کنید.
نام پارامتر توضیحات
key کلید دسترسی
action status
orders کد سفارشات که با کاما (,) از هم جدا شده اند.
در صورتی که درخواست به درستی ارسال شده باشد، هزینه سفارشات، شروع شمارنده، وضعیت، مقدار باقی مانده و واحد پولی برگشت داده میشود. نمونه پاسخ:
{
    "1": {
        "charge": "2000",
        "start_count": "324",
        "status": "Completed",
        "remains": "0",
        "currency": "Toman"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "12400",
        "start_count": "672",
        "status": "Pending",
        "remains": "1200",
        "currency": "Toman"
    },
}
    

دریافت موجودی حساب

برای مشاهده موجودی حساب، باید یک درخواست که شامل پارامترهای زیر میباشد را به آدرس ذکر شده ارسال کنید.
نام پارامتر توضیحات
key کلید دسترسی
action balance
در صورتی که درخواست به درستی ارسال شده باشد، موجودی حساب و واحد پولی برگشت داده میشود. نمونه پاسخ:
{
    "balance": "359200",
    "currency": "Toman"
}