این سرویس برای استعلام وضعیت نظام وظیفه استفاده میشود. درخواست را با توکن معتبر ارسال کنید و نتیجه را در فیلد data پاسخ بخوانید.
:::
برای استفاده از این سرویس، پارامترهای زیر را با متد POST به آدرس مشخصشده ارسال کنید.
| نام | نوع | الزامی | توضیحات |
|---|---|---|---|
| birthDate | رشته | خیر | تاریخ تولد |
| nationalCode | رشته | بله | کد ملی |
تمامی دادههای برگشتی از API به صورت JSON هستند.
https://zarin-hub.com/api/v5/KYC/MilitaryInquiry
نمونه درخواست:
<?php
$curl = curl_init('https://zarin-hub.com/api/v5/KYC/MilitaryInquiry');
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {ACCESS_TOKEN}',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => '{"birthDate":"1370/01/01","nationalCode":"0013546299"}',
]);
$response = curl_exec($curl);
curl_close($curl);
نمونه پاسخ موفق:
{
"meta": {
"trackId": "9b126e9a-184c-4cb0-a47e-62b9a3b7176f",
"status": "success",
"isSuccess": true,
"code": 0,
"message": "عملیات با موفقیت انجام شد",
"errorMessage": null,
"errors": [],
"errorType": null
},
"data": {}
}
نمونه پاسخ ناموفق:
{
"data": {},
"meta": {
"trackId": null,
"status": "error",
"isSuccess": false,
"code": -1,
"message": "درخواست ناموفق بود",
"errorMessage": "پارامترهای درخواست نامعتبر هستند",
"errorType": "validation_error",
"errors": []
}
}