La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye
as_of: qué tan actualizados están los datos. Cómo funcionan los datasets.Buscar normas
POST /cl/leychile/norms-search/v1 Dataset
Una sola búsqueda sobre todas las leyes, códigos, DFL, DL, autos acordados, tratados y decretos supremos que Croma mantiene de Ley Chile.
as_of (qué tan actualizados están los datos), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y results[]: primero los que mejor coinciden cuando hay query, si no, de la publicada más recientemente a la más antigua. Cada resultado incluye norm_id (el id permanente de BCN, p. ej. 1176603), name (p. ej. Ley 21450), type, number, title, common_names, issuing_bodies, publication_date, promulgation_date, year, current_version_date (desde cuándo rige el texto vigente hoy) y version_kind, repealed y repeal_date, treaty, subjects, summary, categories, gazette, gazette_number y cve (el código de verificación del Diario Oficial), version_count, article_count, official_url (la página de la norma en Ley Chile), source_document_url, y document_url y xml_url (las copias de Croma del PDF y el XML de BCN de la versión vigente). Los campos que BCN no indica vienen en null.
Los resultados de búsqueda no incluyen el texto, las versiones ni el historial de documentos; los devuelve el endpoint Ley Chile Norm.
Croma lee las normas nuevas cada día, y las normas que modifican hasta que BCN publica su nuevo texto refundido, y revisa toda la colección una vez al mes.
Una norma, completa
POST /cl/leychile/norm/v1 Dataset
as_of, found, norm_id y norm, que trae todo lo que devuelve la búsqueda más versions (cada versión del texto, de la más reciente a la más antigua, con su kind, from_date, to_date, url y modified_by: las normas cuyos cambios produjeron la versión siguiente, con su norm_id, type, number, title, change, publication_date y effective_date), modified_by_ids, document_versions (cada PDF y XML que Croma ha guardado, con version_date, document_url, xml_url y bytes), modifies (las normas cuyo historial de versiones la registra como modificatoria) y articles, un tramo de las partes del texto vigente con offset, has_more y next_offset. Cada resultado incluye norm_id (el id permanente de BCN, p. ej. 1176603), name (p. ej. Ley 21450), type, number, title, common_names, issuing_bodies, publication_date, promulgation_date, year, current_version_date (desde cuándo rige el texto vigente hoy) y version_kind, repealed y repeal_date, treaty, subjects, summary, categories, gazette, gazette_number y cve (el código de verificación del Diario Oficial), version_count, article_count, official_url (la página de la norma en Ley Chile), source_document_url, y document_url y xml_url (las copias de Croma del PDF y el XML de BCN de la versión vigente). Los campos que BCN no indica vienen en null. Cada parte incluye norm_id, norm_name, norm_type, part_id (el id de BCN para la parte, estable entre versiones), position (su lugar en el texto, 0 para el encabezado), level y parent_part_id (el capítulo o título que la contiene), kind (Artículo, Capítulo, Título, Disposición Transitoria, Anexo, Encabezado, Promulgación…), name (p. ej. 1 para el Artículo 1), heading, text, transitory, repealed y version_date (la versión de la que viene su texto).
Las normas largas se leen por tramos de partes: envía
offset y limit, y luego pasa next_offset como offset hasta que has_more sea falso.Una norma que Croma no tiene devuelve
found: false con HTTP 200, no un error.Buscar dentro de los artículos
POST /cl/leychile/articles-search/v1 Dataset
Encuentra el artículo que dice algo, en todas las normas o dentro de una.
as_of, query, norm_id, total y total_is_exact, page, per_page, total_pages, count y results[]: primero las que mejor coinciden cuando hay query, si no, en el orden del texto. Cada parte incluye norm_id, norm_name, norm_type, part_id (el id de BCN para la parte, estable entre versiones), position (su lugar en el texto, 0 para el encabezado), level y parent_part_id (el capítulo o título que la contiene), kind (Artículo, Capítulo, Título, Disposición Transitoria, Anexo, Encabezado, Promulgación…), name (p. ej. 1 para el Artículo 1), heading, text, transitory, repealed y version_date (la versión de la que viene su texto).
Referencia completa
Esquemas, todos los campos de respuesta y un playground interactivo.