인증서 업로드

자격증 업로드

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

별표(*)로 표시된 필드는 필수입니다.

Headers

Name	Type	Description
Content-Type*	String	application/json
x-http-authorization*	String	https://iafcertsearch.org/import-management/api-integration에서 받은 API 키 예시: x-http-authorization: <<API KEY>>

Request Body

Name	Type	Description
certificate_number*	String
certification_status*	String	허용되는 값: active inactive suspended cancelled hidden withdrawn expired *참고: hidden 자격증 상태로 API를 통해 업로드된 자격증은 IAF CertSearch에 로그인하면 "Draft(초안)"로 표시됩니다.
certificate_accreditation_status	String	허용되는 값: Accredited Unaccredited
certification_type*	String
certification_scope	String
certification_original_issue_date	String	형식: YYYYMMDD
certification_issue_date*	String	형식: YYYYMMDD
certification_expiry_date*	String	형식: YYYYMMDD
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
confidential_certified_entity	Boolean
accreditation_body_name*	String
accreditation_body_acronym_name*	String
certification_body_name*	String
certification_body_acronym_name*	String
schemes*	Array	예시 { "schemes": [ ] }
sites	Array	예시 { "sites": [ ] } 인증서의 모든 기존 사이트를 삭제하려면 sites 키의 값을 빈 배열로 설정하세요. { "sites": [] }

200: OK 요청이 성공했습니다.

{
  "data": true,
  "company_certifications_id": string
}

400: Bad Request API 응답에 설명된 다른 오류.

{
    "error": true,
    "timestamp": number (Epoch time),
    "elapse": number,
    "errors": {
      "message": "error_message",
      "code": "error_code"
    }
}

401: Unauthorized 잘못된 API 키를 사용한 경우 발생합니다.

{
    "error": true,
    "timestamp": number (Epoch time),
    "elapse": number,
    "errors": {
      "message": "잘못된 세션 토큰이 사용되었습니다.",
      "code": "invalid_session_token"
    }
}

422: Unprocessable Entity 검증에 실패했습니다.

{
    "error": true,
    "timestamp": number (Epoch time),
    "elapse": number,
    "errors": {
        "code": "validation_error",
        "message": {
            "field_name": "error_message"
        }
    }
}

자격증 업로드

인증 데이터 게시 중에 오류를 피하려면 API 요청 간에 1분 간격을 유지하는 것이 좋습니다.

응답 데이터 예시를 보려면 응답 설명의 오른쪽 화살표를 클릭하세요.

Sandbox 서버에서 테스트하려면 https://api.sandbox.iafcertsearch.org/api/client/v1/mncb/upload-cert를 사용할 수도 있습니다.

이 방법을 호출하는 방법을 살펴보세요:

cURL

curl --location --request POST 'https://api.iafcertsearch.org/api/client/v1/mncb/upload-cert' \
--header 'Content-Type: application/json' \
--header 'x-http-authorization: <<API_KEY>>' \
--data-raw '{
	"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",
	"confidential_certified_entity": "boolean",
	"accreditation_body_name": "string",
	"accreditation_body_acronym_name": "string",
	"certification_body_name": "string",
	"certification_body_acronym_name": "string",
	"schemes": [
		{
			"scheme_name": "string",
			"standard_list": [
				{
					"standards_name": "string"
				}
			]
		}
	],
	"sites": [
		{
			"street": "string",
			"city": "string",
			"state": "string",
			"country": "string",
			"postcode": "string",
			"scope_description": "string"
		}
	]
}'

Ruby

require "uri"
require "json"
require "net/http"

url = URI("https://api.iafcertsearch.org/api/client/v1/mncb/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({
  "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",
  "confidential_certified_entity": "boolean",
  "accreditation_body_name": "string",
  "accreditation_body_acronym_name": "string",
  "certification_body_name": "string",
  "certification_body_acronym_name": "string",
  "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

Python

import http.client
import json

conn = http.client.HTTPSConnection("api.iafcertsearch.org")
payload = json.dumps({
  "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",
  "confidential_certified_entity": "boolean",
  "accreditation_body_name": "string",
  "accreditation_body_acronym_name": "string",
  "certification_body_name": "string",
  "certification_body_acronym_name": "string",
  "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': '<<API_KEY>>'
}
conn.request("POST", "/api/client/v1/mncb/upload-cert", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.iafcertsearch.org/api/client/v1/mncb/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 =>'{
	"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",
	"confidential_certified_entity": "boolean",
	"accreditation_body_name": "string",
	"accreditation_body_acronym_name": "string",
	"certification_body_name": "string",
  	"certification_body_acronym_name": "string",
	"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;

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n\t\"certificate_number\": \"string\",\r\n\t\"certification_status\": \"string\",\r\n\t\"certificate_accreditation_status\": \"string\",\r\n\t\"certification_type\": \"string\",\r\n\t\"certification_scope\": \"string\",\r\n\t\"certification_original_issue_date\": \"string\",\r\n\t\"certification_issue_date\": \"string\",\r\n\t\"certification_expiry_date\": \"string\",\r\n\t\"certified_entity_name\": \"string\",\r\n\t\"certified_entity_english_name\": \"string\",\r\n\t\"certified_entity_trading_name\": \"string\",\r\n\t\"certified_entity_unique_id\": \"string\",\r\n\t\"certified_entity_street_address\": \"string\",\r\n\t\"certified_entity_street_city\": \"string\",\r\n\t\"certified_entity_state\": \"string\",\r\n\t\"certified_entity_post_code\": \"string\",\r\n\t\"certified_entity_country\": \"string\",\r\n\t\"certified_entity_website\": \"string\",\r\n\t\"confidential_certified_entity\": \"boolean\",\r\n\t\"accreditation_body_name\": \"string\",\r\n\t\"accreditation_body_acronym_name\": \"string\",\r\n\t\"certification_body_name\": \"string\",\r\n\t\"certification_body_acronym_name\": \"string\",\r\n\t\"schemes\": [\r\n\t\t{\r\n\t\t\t\"scheme_name\": \"string\",\r\n\t\t\t\"standard_list\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"standards_name\": \"string\"\r\n\t\t\t\t}\r\n\t\t\t]\r\n\t\t}\r\n\t],\r\n\t\"sites\": [\r\n\t\t{\r\n\t\t\t\"street\": \"string\",\r\n\t\t\t\"city\": \"string\",\r\n\t\t\t\"state\": \"string\",\r\n\t\t\t\"country\": \"string\",\r\n\t\t\t\"postcode\": \"string\",\r\n\t\t\t\"scope_description\": \"string\"\r\n\t\t}\r\n\t]\r\n}");
Request request = new Request.Builder()
  .url("https://api.iafcertsearch.org/api/client/v1/mncb/upload-cert")
  .method("POST", body)
  .addHeader("Content-Type", "application/json")
  .addHeader("x-http-authorization", "<<API_KEY>>")
  .build();
Response response = client.newCall(request).execute();

Node.js

var axios = require('axios');
var data = JSON.stringify({
  "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",
  "confidential_certified_entity": "boolean",
  "accreditation_body_name": "string",
  "accreditation_body_acronym_name": "string",
  "certification_body_name": "string",
  "certification_body_acronym_name": "string",
  "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/mncb/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);
});

Go

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.iafcertsearch.org/api/client/v1/mncb/upload-cert"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
	"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",`+"
"+`
        "confidential_certified_entity": "boolean",`+"
"+`
	"accreditation_body_name": "string",`+"
"+`
	"accreditation_body_acronym_name": "string",`+"	
"+`
	"certification_body_name": "string",`+"
"+`
	"certification_body_acronym_name": "string",`+"
"+`
	"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))
}

C#

var client = new RestClient("https://api.iafcertsearch.org/api/client/v1/mncb/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" +
@"	""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" +
@"	""confidential_certified_entity"": ""boolean"",
" + "\n" +
@"	""accreditation_body_name"": ""string"",
" + "\n" +
@"	""accreditation_body_acronym_name"": ""string"",
" + "\n" +
@"	""certification_body_name"": ""string"",
" + "\n" +
@"	""certification_body_acronym_name"": ""string"",
" + "\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" +
@"}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);