{"openapi":"3.1.0","info":{"title":"OCR Cédula Chile","description":"Procesa pares de imágenes de cédula chilena y devuelve campos estructurados, retrato recortado y métricas de calidad MRZ.\n\n**Documentación adicional:**\n- [Guía de Integración](/guide) — cómo interpretar resultados, árbol de decisión, FAQ\n- [ReDoc](/redoc) — especificación alternativa\n- [OpenAPI JSON](/openapi.json) — para importar en Postman / Insomnia","version":"1.0.0"},"paths":{"/health":{"get":{"tags":["ops"],"summary":"Liveness probe","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/ready":{"get":{"tags":["ops"],"summary":"Readiness probe","operationId":"ready_ready_get","parameters":[{"name":"request_state","in":"query","required":false,"schema":{"type":"null","title":"Request State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cedula":{"post":{"tags":["ocr"],"summary":"Procesar cédula de identidad chilena","description":"Recibe las dos caras de una cédula chilena (JPEG) y devuelve los campos\nresueltos, el retrato recortado en base64 y métricas de calidad.\n\n- **anverso**: imagen del frente de la cédula (`.jpeg`).\n- **reverso**: imagen del reverso con el MRZ (`.jpeg`).","operationId":"procesar_cedula_v1_cedula_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_procesar_cedula_v1_cedula_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CedulaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_procesar_cedula_v1_cedula_post":{"properties":{"anverso":{"type":"string","format":"binary","title":"Anverso"},"reverso":{"type":"string","format":"binary","title":"Reverso"},"idvc_token":{"type":"string","title":"Idvc Token","description":"Token Bearer para el WS de IDVC"},"run_esperado":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Esperado","description":"RUT conocido (ej: 11.915.704-8) para puntuar el OCR"}},"type":"object","required":["anverso","reverso","idvc_token"],"title":"Body_procesar_cedula_v1_cedula_post"},"CedulaResponse":{"properties":{"doc_type":{"type":"string","title":"Doc Type"},"fields":{"additionalProperties":{"$ref":"#/components/schemas/FieldOut"},"type":"object","title":"Fields"},"portrait":{"$ref":"#/components/schemas/PortraitOut"},"quality":{"$ref":"#/components/schemas/QualityOut"},"validation":{"anyOf":[{"$ref":"#/components/schemas/ValidationOut"},{"type":"null"}]}},"type":"object","required":["doc_type","fields","portrait","quality"],"title":"CedulaResponse"},"FieldOut":{"properties":{"anverso":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Anverso"},"reverso":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reverso"},"candidato":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Candidato"},"fuente":{"anyOf":[{"type":"string","enum":["mrz","mrz_corrected","disagreement","mrz_no_checksum","anverso"]},{"type":"null"}],"title":"Fuente"},"coincide":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Coincide"},"run_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Run Valid"}},"type":"object","title":"FieldOut"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PortraitOut":{"properties":{"b64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"B64"},"bbox":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Bbox"},"source":{"anyOf":[{"type":"string","enum":["bbox_face","fallback"]},{"type":"null"}],"title":"Source"}},"type":"object","title":"PortraitOut"},"QualityOut":{"properties":{"mrz_checksums_ok":{"type":"boolean","title":"Mrz Checksums Ok"},"case_class":{"type":"string","enum":["ok","corrected","disagreement"],"title":"Case Class"},"fields_matched":{"type":"string","title":"Fields Matched"},"fields_corrected":{"type":"integer","title":"Fields Corrected"},"fields_disagreed":{"type":"integer","title":"Fields Disagreed"},"anverso_http":{"type":"integer","title":"Anverso Http"},"reverso_http":{"type":"integer","title":"Reverso Http"}},"type":"object","required":["mrz_checksums_ok","case_class","fields_matched","fields_corrected","fields_disagreed","anverso_http","reverso_http"],"title":"QualityOut"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ValidationOut":{"properties":{"run":{"$ref":"#/components/schemas/ValidationRunOut"}},"type":"object","required":["run"],"title":"ValidationOut"},"ValidationRunOut":{"properties":{"expected":{"type":"string","title":"Expected"},"expected_valid":{"type":"boolean","title":"Expected Valid"},"matches_anverso":{"type":"boolean","title":"Matches Anverso"},"matches_reverso":{"type":"boolean","title":"Matches Reverso"},"matches_candidato":{"type":"boolean","title":"Matches Candidato"},"similarity_anverso":{"type":"number","title":"Similarity Anverso"},"similarity_reverso":{"type":"number","title":"Similarity Reverso"},"similarity_candidato":{"type":"number","title":"Similarity Candidato"},"score":{"type":"number","title":"Score"}},"type":"object","required":["expected","expected_valid","matches_anverso","matches_reverso","matches_candidato","similarity_anverso","similarity_reverso","similarity_candidato","score"],"title":"ValidationRunOut"}}}}