You need to enable JavaScript to use this application.
POST شناخت کسب‌وکار

Enamad Inquiry API

Returns Enamad certificate details (license holder, registered date, expiration date) by company name and website.

POST /api/services/enamad-inquiry/
نیاز به احراز هویت Token 60 requests/minute

مستندات

Overview

Overview

با نام شرکت و آدرس وب‌سایت، اطلاعات گواهینامه اینماد (دارنده، تاریخ ثبت، تاریخ انقضا) برمی‌گردد.

Billing

Billing

فقط در صورت موفقیت استعلام از کیف پول کسر می‌شود.

IP Whitelist

IP Whitelist

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

مثال‌های کد

Python Example

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())
cURL Example

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"}' 

فرمت پاسخ

200
پاسخ موفق

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
}
400
خطا

Invalid company_name or website.

ساختار پاسخ:
{
  "error": "object",
  "success": "boolean"
}
مثال پاسخ:
{
  "error": {
    "code": "INVALID_PARAMETERS",
    "message": "پارامترهای ورودی نامعتبر است."
  },
  "success": false
}
401
خطا

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."
}
402
خطا

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
}
403
خطا

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
}
502
خطا

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
}