Overview
با نام شرکت و آدرس وبسایت، اطلاعات گواهینامه اینماد (دارنده، تاریخ ثبت، تاریخ انقضا) برمیگردد.
Returns Enamad certificate details (license holder, registered date, expiration date) by company name and website.
/api/services/enamad-inquiry/
با نام شرکت و آدرس وبسایت، اطلاعات گواهینامه اینماد (دارنده، تاریخ ثبت، تاریخ انقضا) برمیگردد.
فقط در صورت موفقیت استعلام از کیف پول کسر میشود.
Every request is checked against the IP list registered on your account (dashboard → security settings). Requests from any other IP — or from any IP when no IP is registered — are rejected with 403 IP_NOT_ALLOWED (checked right after token authentication, before the provider is called; nothing is charged).
{
"success": false,
"error": {
"code": "IP_NOT_ALLOWED",
"message": "درخواست از آدرس IP ثبتنشده ارسال شده است. فقط IPهای ثبتشده مجاز هستند.",
"details": {"client_ip": "203.0.113.10"}
}
}details.client_ip shows the IP the server saw; register exactly that public IP of your server.
| پارامتر | نوع | اجباری | توضیحات | مثال |
|---|---|---|---|---|
company_name
|
String | اجباری |
Company name (نام شرکت).
اعتبارسنجی: Non-empty string. |
فین و تک پارس
|
website
|
String | اجباری |
Company website domain (scheme optional).
اعتبارسنجی: Valid domain; http/https prefix is stripped. |
example.ir
|
Example using Python requests.
import requests
url = "https://inquiry.sepal.ir/api/services/enamad-inquiry/"
headers = {
"Authorization": "Token YOUR_AUTH_TOKEN",
"X-Unique-Code": "YOUR_UNIQUE_CODE",
"Content-Type": "application/json",
}
payload = {"company_name": "فین و تک پارس", "website": "example.ir"}
print(requests.post(url, json=payload, headers=headers).json())
Command-line cURL example.
curl -X POST "https://inquiry.sepal.ir/api/services/enamad-inquiry/" \
-H "Authorization: Token YOUR_AUTH_TOKEN" \
-H "X-Unique-Code: YOUR_UNIQUE_CODE" \
-H "Content-Type: application/json" \
-d '{"company_name": "فین و تک پارس", "website": "example.ir"}'
Enamad certificate details returned; wallet charged.
{
"amount": "integer",
"success": "boolean",
"request_ref": "string",
"response_data": "object",
"response_time_ms": "integer"
}
{
"amount": 25000,
"success": true,
"request_ref": "ABCDEFGHIJKLMNOPQRSTUVWXYZ012345",
"error_message": null,
"response_data": {
"ref_id": "abee0f-6c9e-fe88d-5a0",
"license_holder": "فین و تک پارس",
"operation_time": 1762629953669,
"expiration_date": "1405/04/01",
"registered_date": "1401/04/01"
},
"response_time_ms": 2100
}
Invalid company_name or website.
{
"error": "object",
"success": "boolean"
}
{
"error": {
"code": "INVALID_PARAMETERS",
"message": "پارامترهای ورودی نامعتبر است."
},
"success": false
}
Missing or invalid Authorization token / X-Unique-Code. Body is DRF's {"detail": ...} (no success/error envelope). No charge.
{
"detail": "string"
}
{
"detail": "Invalid registration source credentials. Token or unique code is incorrect or inactive."
}
Wallet balance is below the service tariff (25,000 Rials), or in-flight requests already reserve it. The provider is not called. No charge.
{
"error": {
"code": "string",
"details": "object (optional)",
"message": "string"
},
"success": "boolean (false)"
}
{
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "موجودی ناکافی. موجودی فعلی: 0 ریال، مبلغ مورد نیاز: 25,000 ریال"
},
"success": false
}
Request IP is not in the account's registered IP list (or no IP is registered). Register the server IP in the dashboard. No charge.
{
"error": {
"code": "string",
"details": {
"client_ip": "string"
},
"message": "string"
},
"success": "boolean (false)"
}
{
"error": {
"code": "IP_NOT_ALLOWED",
"details": {
"client_ip": "203.0.113.10"
},
"message": "درخواست از آدرس IP ثبتنشده ارسال شده است. فقط IPهای ثبتشده مجاز هستند."
},
"success": false
}
Upstream provider unreachable or failed. When the provider answers with its own 5xx, that status is returned with error.errors[0].code = SERVICE_UNAVAILABLE. No charge.
{
"error": {
"code": "string",
"details": "object (optional)",
"message": "string"
},
"success": "boolean (false)"
}
{
"error": {
"code": "SERVICE_ERROR",
"message": "سرویس استعلام در دسترس نیست. لطفاً دوباره تلاش کنید."
},
"success": false
}