Overview
با شناسه ملی ۱۱ رقمی شرکت، آگهیهای روزنامه رسمی برمیگردد.
Returns official newspaper (روزنامه رسمی) ads for an Iranian company by national ID (11 digits).
/api/services/corporate-journal/
با شناسه ملی ۱۱ رقمی شرکت، آگهیهای روزنامه رسمی برمیگردد.
فقط در صورت موفقیت استعلام از کیف پول کسر میشود.
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_national_id
|
String | اجباری |
Iranian company national ID (شناسه ملی شرکت), exactly 11 digits.
اعتبارسنجی: Exactly 11 numeric digits. |
14007111888
|
Example using Python requests.
import requests
url = "https://inquiry.sepal.ir/api/services/corporate-journal/"
headers = {
"Authorization": "Token YOUR_AUTH_TOKEN",
"X-Unique-Code": "YOUR_UNIQUE_CODE",
"Content-Type": "application/json",
}
payload = {"company_national_id": "14007111888"}
print(requests.post(url, json=payload, headers=headers).json())
Command-line cURL example.
curl -X POST "https://inquiry.sepal.ir/api/services/corporate-journal/" \
-H "Authorization: Token YOUR_AUTH_TOKEN" \
-H "X-Unique-Code: YOUR_UNIQUE_CODE" \
-H "Content-Type: application/json" \
-d '{"company_national_id": "14007111888"}'
Corporate journal ads 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": "a6fd38c4-253a-461d-a47d-af3ad4200a6a",
"journals": [
{
"title": "11111111111",
"news_id": "11111111",
"capital_to": 100000000,
"company_id": "14007111888",
"description": "نمونه",
"page_number": 2,
"newspaper_city": "تهران",
"newspaper_date": "2018-12-08T00:00:00",
"newsletter_date": "2018-06-13T00:00:00",
"indicator_number": "111111100111111111",
"newspaper_number": "21477"
}
],
"operation_time": 1762629953669
},
"response_time_ms": 2100
}
Invalid company_national_id.
{
"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
}