ورودی
- شناسه ملی
companyNationalIdیازده رقم با رقم کنترلی معتبر. اعتبار ساختاری با استعلام ثبت شرکتها فرق دارد.
خروجی
- نام
nameنام آزمایشی شرکت. - یافت شد
foundنتیجه منفی معتبر یعنی شناسه در منبع آزمایشی نیست.
نمونهٔ درخواست و شکل پاسخ
نمونهٔ ساختار است و نتیجهٔ یک فراخوانی واقعی نیست.
POST /v1/services/company-inquiry/execute
Authorization: Bearer zh_test_…
Idempotency-Key: <unique-per-operation>
{
"input": {
"companyNationalId": "10100000103"
}
}{
"requestId": "sreq_…",
"status": "SUCCEEDED | NEGATIVE | FAILED | UNKNOWN",
"data": { … },
"error": null,
"billing": { "status": "CHARGED | RELEASED | PENDING_RECONCILIATION", "amountRial": "…", "currency": "IRR" },
"mock": true
}خطاها و هزینه
VALIDATION_ERRORورودی از نظر ساختاری نامعتبر است و هزینهای ندارد.بدون هزینهFORBIDDENحساب یا کلید به این سرویس دسترسی ندارد و هزینهای ندارد.بدون هزینهRATE_LIMITEDمحدودیت نرخ اعمال شده و هزینهای ندارد.بدون هزینهINSUFFICIENT_FUNDSموجودی قابل استفاده کافی نیست و رزروی انجام نمیشود.بدون هزینهPROVIDER_ERRORخطای فنی قطعی است و رزرو آزاد میشود.بدون هزینهPROVIDER_TIMEOUTنتیجه نامعلوم است. وجه تا تعیین تکلیف رزرو میماند.بدون هزینهرفتار محیط آزمایشی: ده رقم اول شناسه ملی: پایان 90 عدم وجود، 91 خطای فنی، 92 مهلت نامعلوم.