شهادة الرفع الجماعي
Last updated
Last updated
POST
https://api.iafcertsearch.org/api/client/v1/cb/bulk-upload-cert
الحقول التي تحمل علامة النجمة (*
) إلزامية.
الرمز ([*]
) يُستخدم للإشارة إلى أن حقلًا معينًا هو جزء من مجموعة من كائنات الشهادات.
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
{
"data": {
"success": true
}
}
{
"data": {
"errors": {
"record_index": 0,
"errors": [
{
"message": "رسالة_الخطأ",
"code": "كود_الخطأ",
"meta": {
"field_name": "المدخل"
}
}
]
}
}
}
{
"error": true,
"timestamp": number (زمن الحقبة),
"elapse": number,
"errors": {
"message": "تم استخدام رمز جلسة غير صالح.",
"code": "رمز_جلسة_غير_صالح"
}
}
{
"error": true,
"timestamp": number (زمن الحقبة),
"elapse": number,
"errors": {
"code": "خطأ_التحقق",
"message": {
"field_name": "رسالة_الخطأ"
}
}
}
تحميل الشهادة الجماعي
نوصي بوجود فاصل زمني يبلغ 10 دقائق بين طلبات واجهة برمجة التطبيقات لتجنب الأخطاء أثناء نشر بيانات الشهادات.
لعرض مثال على بيانات الاستجابة، انقر على السهم الأيمن في الجانب الأيمن من وصف الاستجابة.
يمكنك أيضًا استخدام https://api.sandbox.iafcertsearch.org/api/client/v1/cb/bulk-upload-cert للاختبار على خادم الاختبار.
ألقِ نظرة على كيفية استدعاء هذه الطريقة:
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"
}
]
}
]
}'
require "uri"
require "json"
require "net/http"
url = URI("https://api.iafcertsearch.org/api/client/v1/cb/bulk-upload-cert")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["x-http-authorization"] = "<<API_KEY>>"
request.body = JSON.dump({
"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"
}
]
}
]
})
response = https.request(request)
puts response.read_body
import http.client
import json
conn = http.client.HTTPSConnection("api.iafcertsearch.org")
payload = json.dumps({
"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"
}
]
}
]
})
headers = {
'Content-Type': 'application/json',
'x-http-authorization': '65603d8724a92'
}
conn.request("POST", "/api/client/v1/cb/bulk-upload-cert", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.iafcertsearch.org/api/client/v1/cb/bulk-upload-cert',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"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"
}
]
}
]
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'x-http-authorization: <<API_KEY>>'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n \"certifications\": [\n {\n \"certificate_number\": \"string\",\n \"certification_status\": \"string\",\n \"certificate_accreditation_status\": \"string\",\n \"certification_type\": \"string\",\n \"certification_scope\": \"string\",\n \"certification_original_issue_date\": \"string\",\n \"certification_issue_date\": \"string\",\n \"certification_expiry_date\": \"string\",\n \"certified_entity_name\": \"string\",\n \"certified_entity_english_name\": \"string\",\n \"certified_entity_trading_name\": \"string\",\n \"certified_entity_unique_id\": \"string\",\n \"certified_entity_street_address\": \"string\",\n \"certified_entity_street_city\": \"string\",\n \"certified_entity_state\": \"string\",\n \"certified_entity_post_code\": \"string\",\n \"certified_entity_country\": \"string\",\n \"certified_entity_website\": \"string\",\n \"accreditation_body_name\": \"string\",\n \"accreditation_body_acronym_name\": \"string\",\n \"confidential_certified_entity\": \"boolean\",\n \"schemes\": [\n {\n \"scheme_name\": \"string\",\n \"standard_list\": [\n {\n \"standards_name\": \"string\"\n }\n ]\n }\n ],\n \"sites\": [\n {\n \"street\": \"string\",\n \"city\": \"string\",\n \"state\": \"string\",\n \"country\": \"string\",\n \"postcode\": \"string\",\n \"scope_description\": \"string\"\n }\n ]\n }\n ]\n}");
Request request = new Request.Builder()
.url("https://api.iafcertsearch.org/api/client/v1/cb/bulk-upload-cert")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.addHeader("x-http-authorization", "<<API_KEY>>")
.build();
Response response = client.newCall(request).execute();
var axios = require('axios');
var data = JSON.stringify({
"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"
}
]
}
]
});
var config = {
method: 'post',
url: 'https://api.iafcertsearch.org/api/client/v1/cb/bulk-upload-cert',
headers: {
'Content-Type': 'application/json',
'x-http-authorization': '<<API_KEY>>'
},
data : data
};
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.iafcertsearch.org/api/client/v1/cb/bulk-upload-cert"
method := "POST"
payload := strings.NewReader(`{
"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"
}
]
}
]
}`)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json")
req.Header.Add("x-http-authorization", "<<API_KEY>>")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
var client = new RestClient("https://api.iafcertsearch.org/api/client/v1/cb/bulk-upload-cert");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("x-http-authorization", "<<API_KEY>>");
var body = @"{" + "\n" +
@" ""certifications"": [" + "\n" +
@" {" + "\n" +
@" ""certificate_number"": ""string""," + "\n" +
@" ""certification_status"": ""string""," + "\n" +
@" ""certificate_accreditation_status"": ""string""," + "\n" +
@" ""certification_type"": ""string""," + "\n" +
@" ""certification_scope"": ""string""," + "\n" +
@" ""certification_original_issue_date"": ""string""," + "\n" +
@" ""certification_issue_date"": ""string""," + "\n" +
@" ""certification_expiry_date"": ""string""," + "\n" +
@" ""certified_entity_name"": ""string""," + "\n" +
@" ""certified_entity_english_name"": ""string""," + "\n" +
@" ""certified_entity_trading_name"": ""string""," + "\n" +
@" ""certified_entity_unique_id"": ""string""," + "\n" +
@" ""certified_entity_street_address"": ""string""," + "\n" +
@" ""certified_entity_street_city"": ""string""," + "\n" +
@" ""certified_entity_state"": ""string""," + "\n" +
@" ""certified_entity_post_code"": ""string""," + "\n" +
@" ""certified_entity_country"": ""string""," + "\n" +
@" ""certified_entity_website"": ""string""," + "\n" +
@" ""accreditation_body_name"": ""string""," + "\n" +
@" ""accreditation_body_acronym_name"": ""string""," + "\n" +
@" ""confidential_certified_entity"": ""boolean""," + "\n" +
@" ""schemes"": [" + "\n" +
@" {" + "\n" +
@" ""scheme_name"": ""string""," + "\n" +
@" ""standard_list"": [" + "\n" +
@" {" + "\n" +
@" ""standards_name"": ""string""" + "\n" +
@" }" + "\n" +
@" ]" + "\n" +
@" }" + "\n" +
@" ]," + "\n" +
@" ""sites"": [" + "\n" +
@" {" + "\n" +
@" ""street"": ""string""," + "\n" +
@" ""city"": ""string""," + "\n" +
@" ""state"": ""string""," + "\n" +
@" ""country"": ""string""," + "\n" +
@" ""postcode"": ""string""," + "\n" +
@" ""scope_description"": ""string""" + "\n" +
@" }" + "\n" +
@" ]" + "\n" +
@" }" + "\n" +
@" ]" + "\n" +
@"}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Content-Type*
String
application/json
x-http-authorization*
String
مفتاح API الذي تم الحصول عليه من https://iafcertsearch.org/import-management/api-integration
مثال:
x-http-authorization: <<مفتاح الوصول>>
certifications.[*]*
String
{
"certifications" : [
{
"certificate_number": "string",
"certification_status": "string",
. . . .
}
]
}
certifications.[*].certificate_number*
String
certifications.[*].certification_status*
String
القيم المقبولة:
فعال
غير فعال
معلق
ملغى
مخفي
مسحوب
منتهي
*ملاحظة: الشهادات المُحمّلة عبر واجهة برمجة التطبيقات بالحالة مخفي
ستظهر باسم "مسودة" عند تسجيل الدخول إلى IAF CertSearch.
certifications.[*].certificate_accreditation_status
String
القيم المقبولة:
معتمد
غير معتمد
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
مثال
{
"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": []
}