๐จ๐ด SIMIT โ ๋ฉดํ ์ ์ง
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/co/simit/suspensiones
SIMIT ์์ ์ด์ ๋ฉดํ ์ ์ง ๋๋ ์ทจ์ ๋ฑ ์ ๋ถ๊ณผ ์ฐ๊ด๋ ์ ์ฌ ์ ๋ณด๋ฅผ ์กฐํํฉ๋๋ค(๋ฐ์ดํฐ ์ ๊ณต ์ ๊ด๋ จ ๊ฒฐ์ยท์ผ์ ํฌํจ). documentType ๊ณผ documentNumber ๋ก ๋ช
์์๋ฅผ ์ง์ ํฉ๋๋ค.
ํค๋(Headers)โ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| name | type | required | description |
|---|---|---|---|
documentType | string | yes | ๋ช
์์ ๋ฌธ์ ์ ํ. ๋ณดํต CC, PA, CE, TI, RC, NIT ๋ฑ. |
documentNumber | string | yes | ์กฐํํ ๋ฌธ์ ๋ฒํธ(๊ณต๋ฐฑยท๊ตฌ๋์ ์์). ๊ธธ์ด ์ด๊ณผ ์ 409 ๊ฐ ๋ ์ ์์ต๋๋ค. |
์์ฒญ(Request)โ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/simit/suspensiones", {
params: { documentType: "CC", documentNumber: "123456789" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/simit/suspensiones"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ต(Response)โ
- 200
- 404
- 409
{
"data": {
"documentType": "CC",
"documentNumber": "123456789",
"firstName": "JUAN CARLOS",
"lastName": "PEREZ LOPEZ",
"fullName": "JUAN CARLOS PEREZ LOPEZ",
"suspensiones": [
{
"numeroResolucion": "RES-2024-000123",
"fechaSuspension": "2024/03/15",
"estado": "VIGENTE",
"motivo": "Sanciรณn por acumulaciรณn de puntos"
}
]
},
"signature": {
"message": "Certified by Verifik.co",
"dateTime": "April 8, 2026 11:00 PM"
},
"id": "IDNT1"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType. missing documentNumber"
}
์ฐธ๊ณ (Notes)โ
- SIMIT ์ ์ฝ๋กฌ๋น์ ์ ๊ตญ ๊ตํต ์๋ฐยท๊ณผํ๋ฃ ํตํฉ ์ ๋ณด ์ฒด๊ณ์ ๋๋ค.
dataํ๋๋ช ๊ณผ ๋ฐฐ์ด ๊ตฌ์กฐ๋ ์์ SIMIT ์๋ต์ ๋ฐ๋ฅด๋ฉฐ, ์์๋ ๋ํ์ ์ธ ํํ์ ๋๋ค.suspensiones๊ฐ ๋น์ด ์์ผ๋ฉด ํด๋น ์กฐํ์์ ์ ์ง ๋ด์ญ์ด ์์์ ์ ์์ต๋๋ค(๋น์ฆ๋์ค ๊ท์น๊ณผ ํจ๊ป ํด์).