وب سرویس اطلاعات شرکت‌ها (Company Info)

در این قسمت به بررسی وب‌سرویس اطلاعات شرکت‌ها (Company Info API) می‌پردازیم. این وب‌سرویس به شما امکان می‌دهد تا اطلاعات پایه و ثبت شرکت‌ها را با استفاده از شناسه ملی دریافت کنید.

این سرویس با دریافت شناسه ملی یک شرکت، اطلاعات ثبتی و پایه آن را بازمی‌گرداند. اطلاعاتی که از این سرویس دریافت می‌شود شامل نام شرکت، شماره ثبت، تاریخ ثبت، آدرس، سرمایه ثبتی، کد پستی، وضعیت فعلی، و سایر جزئیات مربوط به شرکت است.

نحوه استفاده:

روش درخواست (HTTP Method): GET

آدرس درخواست (Endpoint):

{{baseUrl}}/Company/{{CompanyId}}/Info

جایگزین‌های متغیرها:

• {{baseUrl}}: آدرس پایه (https://api.rasm.io/API)
• {{CompanyId}}: شناسه ملی شرکت (به عنوان مثال: 14009396050)

پارامترهای ورودی:

• CompanyId: شناسه ملی شرکت که به‌صورت عددی وارد می‌شود. این پارامتر برای هر درخواست الزامی است.

مثال درخواست:

curl --location --request GET 'https://api.rasm.io/API/Company/14009396050/Info' \
--header 'X-Key: {{XKEY}}'

پاسخ نمونه:

در اینجا یک نمونه پاسخ برای درخواست اطلاعات یک شرکت آورده شده است:

{
    "news": [],
    "id": 14009396050,
    "registrationNo": "564196",
    "title": "پیشگامان رسمی پردازش دانا",
    "registrationTypeId": 5,
    "registrationDate": "2020-08-31T00:00:00",
    "capital": 1000000000,
    "address": "استان تهران، شهرستان تهران، بخش مرکزی، شهر تهران، شهرک قدس (غرب)، کوچه (بی نام)، خیابان گلستان جنوبی، پلاک 21، ساختمان زمرد 1، طبقه 7، واحد شمالی",
    "postalCode": "1465865159",
    "picture": "https://rasmioip.s3.ir-thr-at1.arvanstorage.ir/812386",
    "taxNumber": "14009396050",
    "lat": 35.755761057000,
    "lng": 51.377055022000,
    "website": "",
    "tel": "02191304041",
    "fax": "",
    "mobile": "",
    "email": "amir@rasm.io",
    "status": "فعال",
    "edareKol": "اداره کل ثبت شرکت ها و موسسات غیرتجاری",
    "vahedSabti": "اداره ثبت شرکت ها و موسسات غیرتجاری تهران",
    "lastUpdate": "2023-11-26T00:00:00",
    "registrationType": {
        "id": 5,
        "title": "سهامی خاص",
        "wordUsedToShow": "شرکت سهامی خاص",
    },
    "companyPerson": [],
    "companyNews": null,
    "productSuppliers": null,
    "pictureUrl": "https://rasmioip.s3.ir-thr-at1.arvanstorage.ir/812386",
    "networkLinks": null,
    "samtInfo": null,
    "sajars": null,
    "imports": null,
    "knowledgeBased": null,
    "persianRegistrationDate": "1399/6/10"
}

توضیحات فیلدهای خروجی:

• id: شناسه ملی شرکت.
• registrationNo: شماره ثبت شرکت.
• title: نام کامل شرکت.
• registrationTypeId: شناسه نوع ثبت (مثلاً شرکت سهامی خاص).
• registrationDate: تاریخ ثبت شرکت به فرمت YYYY-MM-DD.
• capital: سرمایه ثبتی شرکت.
• address: آدرس ثبت‌شده شرکت.
• postalCode: کد پستی شرکت.
• taxNumber: کد اقتصادی شرکت.
• lat/lng: مختصات جغرافیایی (در صورت وجود).
• website: وب‌سایت شرکت (در صورت وجود).
• tel/fax/mobile: اطلاعات تماس شرکت.
• email: ایمیل ثبت‌شده شرکت.
• status: وضعیت فعلی شرکت (فعال یا غیرفعال).
• edareKol: نام اداره کل ثبت شرکت‌ها.
• vahedSabti: واحد ثبت شرکت در زیر مجموعه اداره کل.
• lastUpdate: آخرین تاریخ بروزرسانی اطلاعات.
• pictureUrl: لینک تصویر ثبت‌شده شرکت.
• persianRegistrationDate: تاریخ ثبت به تقویم شمسی.

خطاهای احتمالی:

• 400 Bad Request: پارامتر ورودی شناسه ملی اشتباه است.
• 404 Not Found: شرکتی با شناسه ملی داده‌شده یافت نشد.
• 401 Unauthorized: کلید API اشتباه است یا وجود ندارد.

نکات مهم:

• اطمینان حاصل کنید که شناسه ملی (CompanyId) به‌درستی وارد شده باشد.
• برای درخواست‌های متعدد، می‌توانید از Rate Limiting استفاده کنید تا تعداد درخواست‌ها مدیریت شود.

نتیجه‌گیری:

در این قسمت، نحوه دریافت اطلاعات ثبت شرکت‌ها از طریق وب سرویس Company Info API را آموختید. با استفاده از این سرویس، می‌توانید به اطلاعات پایه شرکت‌ها دسترسی پیدا کنید و از این اطلاعات برای تحلیل یا مشاهده جزئیات شرکت‌ها استفاده کنید.