批量上传认证
批量上传认证
POST
https://api.iafcertsearch.org/api/client/v1/cb/bulk-upload-cert
带有星号(*
)的字段为必填项。
符号([*]
)用于表示特定字段是认证对象数组的一部分。
Headers
Content-Type*
String
application/json
x-http-authorization*
String
API密钥来自https://iafcertsearch.org/import-management/api-integration
示例:
x-http-authorization: <<API KEY>>
Request Body
certifications.[*]*
String
{
"certifications" : [
{
"certificate_number": "string",
"certification_status": "string",
. . . .
}
]
}
certifications.[*].certificate_number*
String
certifications.[*].certification_status*
String
接受的值:
active
inactive
suspended
cancelled
hidden
withdrawn
expired
*注意:通过API上传具有 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.[*].accreditation_body_name*
String
certifications.[*].accreditation_body_acronym_name*
String
certifications.[*].confidential_certified_entity
Boolean
certifications.[*].schemes*
Array
Example
{
"schemes": [
{
"scheme_name": "string",
"standard_list": [
{
"standards_name": "string"
}
]
}
]
}
certifications.[*].sites
Array
示例
{
"sites": [
{
"street": "string",
"city": "string",
"state": "string",
"country": "string",
"postcode": "string",
"scope_description": "string
}
]
}
若要删除认证的所有现有地点,请将sites
键的值设置为空数组,如下所示:
{
"sites": []
}
{
"data": {
"success": true
}
}
批量上传认证
我们建议在API请求之间设置10分钟的间隔,以避免在认证数据发布过程中出现错误。
看一下你可能如何调用这个方法
curl --location --request POST 'https://api.iafcertsearch.org/api/client/v1/cb/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",
"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