๐จ๐ด ์ฝ๋กฌ๋น์ โ SISBEN ์ ์
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/co/sisben
documentType ๊ณผ documentNumber ๋ก ๊ณต๊ฐ SISBEN ์กฐํ ํฌํธ์์ ์ ๋ณด๋ฅผ ๊ฐ์ ธ์ต๋๋ค. ๋ธ๋ผ์ฐ์ ์๋ํ๋ฅผ ์ฌ์ฉํ๋ฏ๋ก ์๋ต์ด ์ง์ฐ๋ ์ ์์ต๋๋ค.
ํค๋(Headers)โ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| name | type | required | description |
|---|---|---|---|
documentType | string | yes | CC, CE, PEP, PPT, PA. |
documentNumber | string | yes | ๊ณต๋ฐฑยท๊ตฌ๋์ ์์ด. |
์์ฒญ(Request)โ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/sisben", {
params: { documentType: "CC", documentNumber: "1121329661" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/sisben"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "1121329661"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ต(Response)โ
- 200
- 404
- 409
{
"data": {
"documentType": "CC",
"documentNumber": "1121329661",
"sisbenGroup": "A",
"fullName": "NOMBRE SEGUNDO APELLIDO",
"city": "BOGOTร D.C.",
"department": "CUNDINAMARCA"
},
"signature": {
"message": "Certified by Verifik.co",
"dateTime": "April 8, 2026 11:00 PM"
},
"id": "IDNT1"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [CC,CE,PEP,PPT,PA]"
}
์ฐธ๊ณ (Notes)โ
- ์๋ต๊น์ง ์ ์ด ๊ฑธ๋ฆด ์ ์์ต๋๋ค.
PPT๋ API์์ ํ์ฉ๋๋ ์์ฒ ์์ ๋ณ๊ฒฝ ์ 500 ์ด ๋ ์ ์์ต๋๋ค.