Los errores en la v2 de la API de Google Civic Information se asignan a los códigos de estado HTTP. En la siguiente tabla, se enumera cada error y se proporciona una descripción de este. Cada respuesta de error contiene un elemento reason para el error. En algunos casos, se pueden asignar errores similares al mismo código de estado HTTP y al mismo elemento reason. Estos casos se pueden distinguir aún más para fines de depuración mediante el elemento message. Se recomienda no escribir código que inspeccione el elemento message en la respuesta de error.
La API también puede mostrar errores estándar de la API de Google. Esas descripciones de errores están disponibles en la página Errores estándar.
Es posible que se agreguen errores adicionales en el futuro. Cualquier error nuevo se anunciará en el foro de la API.
Tabla de errores
reason |
Código de estado HTTP | message |
Descripción |
|---|---|---|---|
parseError |
400 |
No se pudo analizar la dirección | La dirección enviada a la API no se pudo analizar. Esto puede suceder si la dirección no está especificada por completo. |
required |
400 |
No se proporcionó una dirección | Se debe especificar una dirección para esta solicitud. |
invalidValue |
400 |
Elecciones desconocidas | Se desconoce la elección que se solicitó. Esto puede deberse a que el ID electoral solicitado no es válido. Esto también puede suceder en el caso de las solicitudes sin un ID electoral especificado si no hay datos disponibles para la dirección proporcionada. |
invalidQuery |
400 |
Fin de las elecciones | La solicitud finalizó la elección. Ya no hay datos disponibles para esta elección. |
unauthorized |
401 |
La solicitud no se autorizó debidamente. | |
limitExceeded |
403 |
Se recuperaron demasiados ID de TOC | La solicitud recursiva requería procesar demasiadas divisiones. Aplica filtros adicionales o usa un ID de TOC más restringido. En algunos casos, puede ser necesario realizar una búsqueda no recursiva seguida de varias búsquedas recursivas en las divisiones más pequeñas que se mostraron. |
notFound |
404 |
No hay información para esta dirección | La API no tiene información sobre esta dirección. Esto puede deberse a que la dirección no es una dirección residencial de EE.UU. Otro motivo para este error es que no hay datos electorales para esta dirección. |
conflict |
409 |
Información en conflicto para esta dirección | Se encontró información en conflicto para esta dirección. Actualmente inactivo. |
backendError |
503 |
La API tiene un problema para responder a la solicitud. Estos tipos de errores se pueden volver a intentar. |