تحميل جماعي للشهادات

Bulk Upload Certification

POST https://api.iafcertsearch.org/api/client/v1/mncb/bulk-upload-cert

الحقول المُشار إليها برمز النجمة (*) إلزامية.

يُستخدم الرمز ([*]) للإشارة إلى أن حقلًا معينًا هو جزء من مجموعة من كائنات الشهادات.

Headers

NameTypeDescription

Content-Type*

String

application/json

x-http-authorization*

String

مفتاح الواجهة البرمجية الذي تم الحصول عليه من https://iafcertsearch.org/import-management/api-integration

مثال:

x-http-authorization: <<مفتاح الواجهة البرمجية>>

Request Body

NameTypeDescription

certifications.[*]*

String

{

"certifications": [

]

}

certifications.[*].certificate_number*

String

certifications.[*].certification_status*

String

القيم المقبولة:

active

inactive

suspended

cancelled

hidden

withdrawn

expired

*ملاحظة: تعرض الشهادات التي تم تحميلها عبر واجهة برمجة التطبيقات بحالة الـ hidden كـ "مسودة" عند تسجيل الدخول إلى IAF CertSearch.

certifications.[*].certificate_accreditation_status

String

القيم المقبولة:

Accredited

Unaccredited

certifications.[*].certification_type*

String

certifications.[*].certification_scope

String

certifications.[*].certification_original_issue_date

String

التنسيق: YYYYMMDD

certifications.[*].certification_issue_date*

String

التنسيق: YYYYMMDD

certifications.[*].certification_expiry_date*

String

التنسيق: YYYYMMDD

certifications.[*].certified_entity_name*

String

certifications.[*].certified_entity_english_name

String

certifications.[*].certified_entity_trading_name

String

certifications.[*].certified_entity_unique_id*

String

certifications.[*].certified_entity_street_address

String

certifications.[*].certified_entity_street_city

String

certifications.[*].certified_entity_state

String

certifications.[*].certified_entity_post_code

String

certifications.[*].certified_entity_country*

String

certifications.[*].certified_entity_website

String

certifications.[*].confidential_certified_entity

Boolean

certifications.[*].accreditation_body_name*

String

certifications.[*].accreditation_body_acronym_name*

String

certifications.[*].certification_body_name*

String

certifications.[*].certification_body_acronym_name*

String

certifications.[*].schemes*

Array

مثال

{

"schemes": [

]

}

certifications.[*].sites

Array

مثال

{

"sites": [

]

}

لحذف جميع المواقع الحالية لشهادة، ضع قيمة مفتاح sites إلى مصفوفة فارغة مثل هذا:

{

"sites": []

}

{
  "data": {
    "success": true
  }
}

تحميل الشهادات بالجملة

نوصي بالحفاظ على فاصل زمني يبلغ 10 دقائق بين طلبات واجهة برمجة التطبيقات لتجنب الأخطاء أثناء نشر بيانات الشهادات.

لعرض مثال على بيانات الاستجابة، انقر على السهم الأيمن في الجانب الأيمن من وصف الاستجابة.

يمكنك أيضًا استخدام https://api.sandbox.iafcertsearch.org/api/client/v1/mncb/bulk-upload-cert لاختباره على خادم الاختبار الرملي (Sandbox).

تفضل بالنظر إلى كيفية استدعاء هذه الطريقة:

curl --location --request POST 'https://api.iafcertsearch.org/api/client/v1/mncb/bulk-upload-cert' \
--header 'Content-Type: application/json' \
--header 'x-http-authorization: <<API_KEY>>' \
--data-raw '{
    "certifications": [
        {
            "certificate_number": "string",
            "certification_status": "string",
            "certificate_accreditation_status": "string",
            "certification_type": "string",
            "certification_scope": "string",
            "certification_original_issue_date": "string",
            "certification_issue_date": "string",
            "certification_expiry_date": "string",
            "certified_entity_name": "string",
            "certified_entity_english_name": "string",
            "certified_entity_trading_name": "string",
            "certified_entity_unique_id": "string",
            "certified_entity_street_address": "string",
            "certified_entity_street_city": "string",
            "certified_entity_state": "string",
            "certified_entity_post_code": "string",
            "certified_entity_country": "string",
            "certified_entity_website": "string",
            "accreditation_body_name": "string",
	    "accreditation_body_acronym_name": "string",
            "certification_body_name": "string",
	    "certification_body_acronym_name": "string",
            "confidential_certified_entity": "boolean",
            "schemes": [
                {
                    "scheme_name": "string",
                    "standard_list": [
                        {
                            "standards_name": "string"
                        }
                    ]
                }
            ],
            "sites": [
                {
                    "street": "string",
                    "city": "string",
                    "state": "string",
                    "country": "string",
                    "postcode": "string",
                    "scope_description": "string"
                }
            ]
        }
    ]
}'

Last updated