๐จ๐ด ์ฝ๋กฌ๋น์ โ ์ธ๊ตญ์ธ CE(Cรฉdula de Extranjero)
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/co/foreigner-id/ce
documentNumber ์ ๋ฐ๊ธ์ผ expeditionDate(DD/MM/YYYY)๋ก ์กฐํํฉ๋๋ค. ๋์ผ ํ๋๋ก POST JSON ๋ณธ๋ฌธ๋ ์ง์ํฉ๋๋ค.
ํค๋(Headers)โ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
์๋ฅ ์๊ฑดโ
๋์: ์ฝ๋กฌ๋น์์ ํฉ๋ฒ ๊ฑฐ์ฃผํ๋ ์ธ๊ตญ์ธ์ผ๋ก Cรฉdula de Extranjerรญa (CE)๋ฅผ ๋ณด์ ํ ๊ฒฝ์ฐ์
๋๋ค. ์ฝ๋กฌ๋น์ ๊ตญ๋ฏผ(CC, /v2/co/cedula)์ด๋ ๋ฒ ๋ค์์๋ผ PPTยท์ด๋ฏผ PEP์๋ ํด๋นํ์ง ์์ต๋๋ค.
| ํ๋ | ์๋ด |
|---|---|
documentNumber | CE ๋ฒํธ, ์ซ์๋ง(๊ณต๋ฐฑยท๊ตฌ๋์ ์์). ์ฝ๋กฌ๋น์์์ CE๋ ๋ณดํต 6 ๋๋ 7์๋ฆฌ(๊ฐ๋ณ ๊ธธ์ด). ์: 712046, 1156043. |
expeditionDate | ๋ฐ๊ธ์ผ DD/MM/YYYY ํ์(์: 15/06/2020). ํ์ โ ์๋ชป๋ ํ์์ 409๊ฐ ์์ฃผ ๋ฐํ๋ฉ๋๋ค. |
์ ์ฒด ๋น๊ต: ์ ๋ถ์ฆ ์ ํ ๊ฐ์ด๋.
๋งค๊ฐ๋ณ์(Parameters)โ
| name | type | required | description |
|---|---|---|---|
documentNumber | string | yes | CE ๋ฒํธ, ์ซ์๋ง. ์ฝ๋กฌ๋น์์์ ์ผ๋ฐ์ ์ผ๋ก 6โ7์๋ฆฌ. ์: 712046, 1156043. |
expeditionDate | string | yes | ๋ฐ๊ธ์ผ DD/MM/YYYY(์: 15/06/2020). ๋ฌธ์์ ์ผ์นํด์ผ ํฉ๋๋ค. |
์์ฒญ(Request)โ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/foreigner-id/ce", {
params: { documentNumber: "987654321", expeditionDate: "15/06/2020" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/foreigner-id/ce"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "987654321", "expeditionDate": "15/06/2020"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ต(Response)โ
- 200
- 404
- 409
{
"data": {
"documentType": "CE",
"documentNumber": "987654321",
"status": "VIGENTE",
"fullName": "MARIA EJEMPLO PEREZ"
},
"signature": {
"message": "Certified by Verifik.co",
"dateTime": "April 20, 2026 10:00 AM"
},
"id": "CE01A"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "expeditionDate must be a valid date in DD/MM/YYYY format"
}
์ฐธ๊ณ (Notes)โ
- ๋ ์ง ํ์์
DD/MM/YYYY์ ๋๋ค. GET/POST๋ชจ๋ ๋์ผ ์ฒ๋ฆฌ์ ๋๋ค.- ์์ฒ ์ฅ์ ์ 404 / 500 ์ด ๋ ์ ์์ต๋๋ค.