๐จ๐ด ์ฝ๋กฌ๋น์ โ SIGEP ๊ณต๋ฌธ์ ์กฐํ (by document)
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/co/sigep/number
documentType ๊ณผ documentNumber ๋ก SIGEP ๋๋ ํฐ๋ฆฌ๋ฅผ ์กฐํํฉ๋๋ค. ์ด๋ฆ๋ง์ผ๋ก ๊ฒ์ํ๋ ค๋ฉด SIGEP (์ด๋ฆ) ์ ์ฌ์ฉํ์ธ์.
ํค๋(Headers)โ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| name | type | required | description |
|---|---|---|---|
documentType | string | yes | CC ๋๋ NIT (API ๊ฒ์ฆ). |
documentNumber | string | yes | ๊ณต๋ฐฑยท๊ตฌ๋์ ์์ด. |
์์ฒญ(Request)โ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/sigep/number", {
params: { documentType: "CC", documentNumber: "34503110" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/sigep/number"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "34503110"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ต(Response)โ
- 200
- 404
- 409
{
"data": {
"fullName": "FRANCIA ELENA MARQUEZ MINA",
"documentType": "CC",
"documentNumber": "34503110",
"records": [],
"legend": ""
},
"signature": {
"message": "Certified by Verifik.co",
"dateTime": "October 27, 2025 8:49 AM"
},
"id": "VMH0I"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [CC,NIT]"
}
์ฐธ๊ณ (Notes)โ
documentType์CC/NIT๋ง ํ์ฉ๋ฉ๋๋ค(UI์ ๋ค๋ฅธ ๊ฐ์ด ๋ณด์ผ ์ ์์).- ๋๋ ํฐ๋ฆฌ์ ์์ผ๋ฉด 200์ ๋น
records์legend๊ฐ ์ฌ ์ ์์ต๋๋ค.