اسکن برای دسترسی با موبایل
مستندات پامپ
راهنمای فنی برای بررسی وضعیت ماموریت کاربران
این API به PUMP اجازه میدهد وضعیت انجام ماموریت یک کاربر را با ارسال شماره موبایل و شناسه ماموریت بررسی کند.
| مورد | توضیح |
|---|---|
| Base URL | https://back.pazh.net/market |
| API Key | کلید اختصاصی برای احراز هویت (از طریق کانال امن ارسال میشود) |
| missionId | شناسه هر ماموریت/کمپین (برای هر کمپین جداگانه) |
| این مستند | راهنمای استفاده از API |
| مورد | توضیح | الزامی |
|---|---|---|
| IP سرور(های) خروجی | IPهایی که درخواستها از آنها ارسال میشود (برای whitelist) | بله |
| لیست ماموریتها | نام کمپینها برای تطبیق با missionId | بله |
| مخاطب فنی | نام و راه ارتباطی برای هماهنگی و رفع مشکل | بله |
| محیط تست | آیا از محیط staging جداگانه استفاده میکنید؟ | خیر |
| حجم تقریبی درخواست | تعداد درخواست در دقیقه/روز (برای ظرفیتسنجی) | خیر |
Endpoint
GET /pump/missions/status
URL کامل
https://back.pazh.net/market/pump/missions/status
احراز هویت
| هدر | مقدار |
|---|---|
x-api-key |
API Key دریافتی از پاژ |
⚠️ علاوه بر API Key، IP درخواستدهنده باید در whitelist پاژ ثبت شده باشد.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
mobile |
string | بله | شماره موبایل کاربر |
missionId |
string | بله | شناسه ماموریت (از پاژ دریافت میشود) |
فرمتهای قابل قبول برای mobile
09121234567
9121234567
989121234567
+989121234567
HTTP Request
GET /pump/missions/status?mobile=09121234567&missionId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx HTTP/1.1 Host: back.pazh.net x-api-key: YOUR_API_KEY
نمونه با curl
curl -X GET \ "https://back.pazh.net/market/pump/missions/status?mobile=09121234567&missionId=YOUR-MISSION-ID" \ -H "x-api-key: YOUR_API_KEY"
ساختار پاسخ
{
"status": true,
"count": 1,
"message": "پرداخت با موفقیت انجام شده"
}
فیلدها
status
true = انجام شده — false = انجام نشده
count
تعداد دفعاتی که ماموریت با موفقیت انجام شده
message
توضیح وضعیت به فارسی
| وضعیت | status | message |
|---|---|---|
| ماموریت انجام شده | true | پرداخت با موفقیت انجام شده |
| ماموریت انجام نشده | false | فرم تکمیل نشده است |
| ماموریت انجام نشده | false | پرداختی یافت نشد |
| شماره نامعتبر | false | شماره موبایل نامعتبر است |
missionId نامعتبر
{
"status": false,
"count": 0,
"message": "ماموریت نامعتبر است"
}
API Key نامعتبر
{
"statusCode": 401,
"message": "Invalid API key"
}
IP مجاز نیست
{
"statusCode": 403,
"message": "IP not allowed"
}
هر دو پارامتر mobile و missionId اجباری هستند.
missionId باید دقیقاً همان مقداری باشد که از پاژ دریافت کردهاید.
در صورت status: false بهدلیل «پرداختی یافت نشد»، ممکن است کاربر تازه پرداخت کرده باشد — توصیه میشود retry با فاصله چند ثانیه داشته باشید.
API Key را در کد سمت کلاینت hardcode نکنید؛ در متغیر محیطی یا secret manager نگه دارید.
فقط از IPهای اعلامشده به پاژ درخواست ارسال کنید.
سمت پاژ
سمت PUMP
لطفا وارد شوید تا نظر دهید
افزودن نظر
دیدگاه