SIMIT โ ์ข ํฉ ์กฐํ
SIMIT ์ข ํฉ ์กฐํ ์๋น์ค๋ ์ฝ๋กฌ๋น์ ๋ด ์ฐจ๋๊ณผ ์ด์ ์์ ๋ํ ๊ตํต ์๋ฐ ์ข ํฉ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค.
์๋ํฌ์ธํธโ
https://api.verifik.co/v2/co/simit/consultar
ํค๋(Headers)โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช |
|---|---|---|---|
documentType | string | ์ | ๋ฌธ์ ์ข
๋ฅ. ํ์ฉ ๊ฐ: CC, PA, CE, TI, RC, NIT. |
documentNumber | string | ์ | ์กฐํํ ๋ฌธ์ ๋ฒํธ. ๊ณต๋ฐฑ์ด๋ ์ ์์ด ์ ๋ ฅํฉ๋๋ค. |
์์ฒญ(Request)โ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/simit/consultar", {
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/consultar"
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
{
"value": {
"value": {
"data": {
"multas": [
{
"infractor": {
"tipoDocumento": "Cรฉdula",
"numeroDocumento": "123456789",
"nombre": "C**",
"apellido": "B**",
"idTipoDocumento": 1
},
"valor": 344730,
"placa": "RDL805",
"infracciones": [
{
"codigoInfraccion": "C35",
"descripcionInfraccion": "No realizar la revisiรณn tรฉcnico-mecรกnica en el plazo legal establecido o cuando el vehiculo no se encuentre en adecuadas condiciones tรฉcnico-mecรกnicas o de emisiรณn de gases, aun cuando porte los certificados correspondientes.",
"valorInfraccion": 344730
}
],
"valorPagar": 344730,
"departamento": "Cundinamarca",
"organismoTransito": "Ricaurte",
"fechaComparendo": "23/02/2016 00:00:00",
"fechaResolucion": "12/12/2022",
"numeroComparendo": "25612001000012662173",
"estadoComparendo": "Pendiente"
}
],
"cursos": [
{
"numeroMulta": "00001234",
"fechaCurso": "21/12/2011",
"numeroCurso": "60462",
"ciudadRealizacion": "Medellin",
"centroInstruccion": "CIA AL INFRACTOR DE TRANSITO",
"estado": "No aplicado",
"certificado": "60462"
}
],
"acuerdosPago": [
{
"resolucion": "324",
"fechaResolucion": "16/02/2018",
"estado": "Acuerdo de pago",
"valorAcuerdo": 837716,
"pendiente": 837716,
"totalPagar": 837716,
"secretaria": "Jamundi",
"departamento": "Valle del Cauca"
}
],
"totalMultasPagar": 31,
"cantMultasPagar": 0,
"totalAcuerdosPagar": 11,
"cantAcuerdosPagar": 0
},
"signature": {"message": "Certified by Verifik.co", "dateTime": "August 31, 2022 4:16 PM"}
}
}
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType. missing documentNumber"
}
๋น๊ณ โ
- ๋ณธ ์ข ํฉ ์๋น์ค๋ ๊ณผํ๋ฃ, ๊ต์ก ๊ณผ์ , ๋ถํ ๋ฉ๋ถ ํฉ์๋ฅผ ํฌํจํ ๊ฐ์ธ์ ๋ชจ๋ SIMIT ๋ฐ์ดํฐ๋ฅผ ์ ๊ณตํฉ๋๋ค.
- "Multas"์๋ ์๋ฐ ์ฝ๋์ ์ค๋ช ์ ํฌํจํ ๊ตํต ์๋ฐ ์์ธ ์ ๋ณด๊ฐ ํฌํจ๋ฉ๋๋ค.
- "Cursos"๋ ํด๋น ๊ฐ์ธ์ด ์ด์ํ ๊ตํต ๊ต์ก ๊ณผ์ ์ ๋ณด์ฌ ์ค๋๋ค.
- "AcuerdosPago"๋ ๋ฏธ๋ฉ ๊ณผํ๋ฃ์ ๋ํ ๋ถํ ๋ฉ๋ถ ํฉ์๋ฅผ ํ์ํฉ๋๋ค.
- ๊ธ์ก์ ์ฝ๋กฌ๋น์ ํ์(COP)๋ก ์ ๊ณต๋ฉ๋๋ค.