Qué significa que un registro de ayuda pública esté "actualizado"
"Actualizado" no es una propiedad sencilla de sí o no. Una URL puede responder hoy mientras la página ya no respalda una cantidad guardada. Una revisión puede apoyar la identidad del programa sin confirmar los fondos. Una fecha que hoy es correcta puede quedar desactualizada mañana. Por eso un registro útil necesita evidencia fechada y limitada en vez de una sola insignia de vigencia.
Interprete la evidencia en contexto: la muestra pública vigente muestra campos freshness de cada registro, el esquema define su significado, la respuesta de salud informa las comprobaciones y revisiones que realmente existen y la respuesta de preparación para la venta publica la decisión comercial vigente. Revise siempre las respuestas actuales en vez de copiar una fecha o cantidad antigua.
Cinco preguntas suelen reducirse incorrectamente a una
| Pregunta | Evidencia pertinente | Lo que no demuestra |
|---|---|---|
| ¿Respondió la URL citada? | linkStatus y lastChecked | Identidad, elegibilidad, cantidad, fecha ni fondos. |
| ¿Se revisó la fuente? | Campos de revisión y confidence limitado | Cada campo ni disponibilidad futura. |
| ¿La fuente respaldó una cantidad guardada? | sourceAmountVerified y su evidencia vinculada cuando exista | Otras cifras, estado, elegibilidad ni adjudicación. |
| ¿El programa acepta solicitudes ahora? | Confirmación actual de la administración | Una etiqueta guardada puede retrasarse. |
| ¿Puede avanzar el acceso o la entrega pagada? | La decisión vigente de preparación y el acuerdo aplicable | La preparación no es una garantía de exactitud ni una opinión sobre derechos para cada uso. |
El estado del enlace es evidencia de transporte
El esquema vigente usa cuatro estados:
live: la URL guardada respondió durante la comprobación limitada. No confirma el programa ni los hechos guardados.dead: la comprobación recibió una respuesta de página no encontrada o retirada según el método de salud publicado.bot-blocked: la solicitud fue bloqueada o limitada. Es inconclusa, no prueba que la página pública esté disponible o no para una persona.unchecked: todavía no existe un resultado útil, o una conexión u otra respuesta fue inconclusa.
Use un enlace muerto como motivo para detener una vía de solicitud inmediata. Trate los estados bloqueado y sin comprobar como razones para una revisión humana prudente. Nunca convierta el hecho de que una URL responda en una afirmación de que el beneficio está abierto.
La revisión de la fuente tiene un alcance
El objeto de vigencia puede indicar si se ejecutó una revisión fechada y si esa revisión está desactualizada según el contrato vigente. El esquema actual considera desactualizada una revisión válida al llegar a 90 días y retira la confianza derivada de la revisión hasta que se actualice.
El alcance importa más que la insignia. model-identity-reviewed significa que una revisión asistida por un modelo consideró que la página y la identidad coincidían, pero no guarda una prueba textual de identidad ni valida la cantidad. source-verified es más limitado de lo que su nombre puede sugerir: exige evidencia vinculada al mismo programa y a la cantidad positiva guardada en el momento de la revisión. Aun así no verifica cada otro campo.
Revisar un hecho no verifica todo el registro
La revisión de una cantidad debe vincular la URL fuente, el nombre del programa, la administración, la cantidad guardada, la función de esa cifra, la fecha y el fragmento de respaldo. No basta encontrar el mismo número en otra parte de la página. Una página puede enumerar varios programas o cifras con significados diferentes.
Incluso una cantidad respaldada no dice por sí sola si el hogar califica, si quedan fondos, si el trabajo ya iniciado es elegible, si se aplica un gravamen ni si puede combinarse con otro programa.
El estado publicado puede cambiar entre comprobaciones
La API expone una etiqueta guardada fundingStatus con valores definidos en el esquema vigente. El esquema advierte que cualquier etiqueta puede retrasarse y que unknown exige confirmar la situación con la administración. Los presupuestos, períodos, listas de espera y asignaciones de emergencia pueden cambiar sin una modificación clara de la página.
Para cualquier uso que oriente decisiones, muestre el estado como contexto publicado, indique la fecha de evidencia cuando esté disponible y envíe al usuario a confirmar el ciclo vigente con la administración.
Las fechas de salud muestran lo que ocurrió, no lo que ocurrirá
El endpoint de salud publica fechas y resultados limitados de operaciones con evidencia. Esas fechas pueden respaldar una frase como "la respuesta informa una fecha de la última comprobación de enlaces". No respaldan "actualizado a diario", "vigilado continuamente" ni una promesa sobre la próxima ejecución.
Si un campo de salud falta, fue sustituido, es nulo o está desactualizado, conserve ese estado. No reutilice un porcentaje antiguo, no convierta una auditoría retirada en una tasa vigente ni infiera que un proceso está activo.
La revisión del conjunto identifica, pero no demuestra vigencia
X-Dataset-Revision ayuda a identificar la generación efectiva usada en una evaluación o informe de corrección. Una revisión distinta puede señalar que cambió alguna entrada vinculada. Una revisión igual no promete que cada fuente siga igual, y la revisión no es una puntuación de exactitud, vigencia, derechos ni preparación.
Muestre al usuario la afirmación honesta más pequeña
Un registro para consumidores puede mostrar:
- el nombre del programa y la administración;
- la URL citada disponible;
- el estado y la etiqueta de cantidad guardados sin convertirlos en promesa;
- la fecha de comprobación o revisión y su alcance exacto cuando sea útil; y
- una instrucción clara para confirmar identidad, elegibilidad, fondos, cantidad, fecha, trabajo permitido y pasos con la administración.
Un resultado vacío válido debe decir que ningún registro coincidió con la consulta, no que no existe ayuda. Una falla del servicio debe seguir siendo un estado no disponible y no convertirse en resultado vacío.
Las correcciones necesitan evidencia y una nueva revisión
Un informe debe indicar ciudad, ID del programa, campo, URL de una fuente oficial, resumen de la fuente y fecha sin incluir información personal del solicitante o propietario. Es evidencia para investigar, no una edición automática. Si se acepta y publica después, conserve la nueva revisión del conjunto y la resolución de la corrección.
No existe una promesa de tiempo de respuesta para soporte o correcciones salvo que un acuerdo revisado lo establezca. La guía de correcciones para desarrolladores explica el límite vigente.
Revise la vigencia como evidencia, no como insignia
Compare un registro de la muestra con el esquema y la respuesta de salud antes de elegir textos o comportamientos alternativos.
Abrir la muestra pública Leer la salud del conjuntoPreguntas comunes
¿live significa que el programa está abierto?
No. Significa que la URL citada resolvió durante la comprobación limitada. Confirme el programa y los fondos actuales con la administración.
¿source-verified significa que todo el registro es correcto?
No. Según el esquema vigente se limita a evidencia del mismo programa y la cantidad positiva guardada. No demuestra cada campo ni una adjudicación futura.
¿El endpoint de salud promete la próxima actualización?
No. Informa evidencia y fechas de operaciones realizadas. No crea un calendario, una afirmación de vigilancia continua ni una garantía de servicio.