Crossref
https://api.crossref.org/works?rows=1
DocumentaciónGuías prácticas detalladas
Defina consulta, paginación, errores y respuesta original antes de transformar los datos.
Actualización :

Ilustración generada por IA
Una API responde a una consulta en un esquema y un momento concretos. No demuestra que se haya solicitado toda la base ni que permanezca estable entre llamadas. Separe el registro de la recogida del análisis.
Lea documentación oficial: versión, alcance, condiciones, autenticación y límites. Para toda una base, busque exportación oficial.
Anote endpoint, método, parámetros, filtros y orden. Prefiera identificadores. Nunca publique claves o tokens.
Guarde estado HTTP, hora, formato y errores. Compruebe campos y unidades; HTTP 200 puede contener vacío o error funcional.
Revise total, páginas y cursores. Cuente filas e identificadores únicos y anote duplicados y condición de parada. La base puede cambiar durante la recogida.
Guarde respuesta y huella; documente limpieza, filtros y conversiones. No publique datos personales o secretos en registros públicos.
Respete indicaciones de reintento ante 429 o indisponibilidad. Otra extracción es otra observación: compare también esquema y selección.
Ilustran la sintaxis; compruebe disponibilidad, autenticación y condiciones en la documentación.
Taller de lectura
Los intercambios HTTP DEMO son ficticios. Este apartado no contacta servidores ni reintenta peticiones.
Datos y registros ficticios para aprender: ninguno de estos resultados procede de una consulta en directo.
El cliente conserva una representación para area=A con su ETag. La política ficticia limita los intentos a dos. No garantiza disponibilidad del servicio.
Abra cada propuesta para comparar su diagnóstico. Pueden seguir siendo necesarios otros controles.
No. El escenario sigue usando la copia de la misma selección. Cuerpo ausente no significa tabla vacía.
No. Cambia silenciosamente el ámbito de las observaciones. Los parámetros forman parte del registro.
Sí. El registro debe identificar los datos usados y los intentos sin una nueva extracción.
Selección: GET /demo?area=A Copia: cuerpo guardado; ETag="demo-v1" Condición: If-None-Match="demo-v1" Respuesta: 304; referencia a copia A Otro intento: 429; Retry-After=15 segundos Política DEMO: dos intentos máximo, después parar Derechos de republicación: comprobar aparte
La cota de dos intentos es del ejemplo, no de los RFC. Sin copia utilizable no invente contenido; prepare otra recuperación conforme a la política del servicio.
Compruebe total y siguiente cursor antes de presentar un recuento completo.
Distinga null, campo ausente, lista vacía y cero; afectan promedios.
Eurostat documenta una base con versiones más recientes. Conserve extracciones fechadas para reproducir cálculos.
Ejercicio resuelto
Ejemplo ficticio: los valores y documentos permiten aprender el método y no describen una organización real.
El contrato de esta API ficticia exige success=true antes del tratamiento. Examine por separado respuesta HTTP, estado de aplicación y presencia de resultados.
Si la tabla supera la pantalla, desplácela horizontalmente; las flechas funcionan cuando la zona tiene el foco.
| Elemento | Información observada |
|---|---|
| Estado HTTP | 200 |
| Indicador de aplicación | success=false |
| Mensaje recibido | Mensaje: cuota alcanzada |
| Matriz de resultados | No se proporciona matriz |
El transporte respondió, pero la recopilación falló según el contrato. No se establece un recuento cero. Marcar fallo y seguir la regla documentada de reintento; no fabricar tabla vacía para continuar el cálculo.
Si una respuesta exitosa contiene realmente una tabla vacía, puede establecerse cero para la consulta y ámbito indicados. Repetir con success=true y un cuerpo JSON truncado: ni estado ni indicador bastan. Rechazar el lote incompleto, conservar el punto de recuperación y comprobar que ningún valor parcial sustituya la última extracción validada.
Guardar consulta sin secretos, estado, error, contrato y situación de reintento.
Referencia documental : IETF — RFC 9110, 200 OK · Consultada el
REFERENCIAS DOCUMENTADAS
Truthy es una proyección técnica por entidad y propiedad: si hay declaraciones preferidas excluye las normales; de lo contrario usa las normales. No vota fuentes ni elige la fecha máxima.
| Referencia | Valor o forma | Qué identifica |
|---|---|---|
| PreferredRank | Preferred | Selecciona todas las preferidas del par. Preferido no implica unicidad. |
| NormalRank | Normal | Selecciona normales solo sin preferidas para ese par. Varios valores normales pueden ser legítimos. |
| DeprecatedRank | Deprecated | Excluye las desaconsejadas de truthy; siguen disponibles completas para documentar errores o rechazos. |
| wdt: | Best non-deprecated rank | El camino directo usa mejores rangos no desaconsejados sin calificadores. No garantiza actualidad, integridad o respaldo. |
| wikibase:BestRank | Full statement selection | Este tipo selecciona nodos completos de mejor rango y conserva acceso a calificadores y referencias. |
| Scope | Entity + property | La regla depende de entidad y propiedad. Preferir población no selecciona fundación, nombre u otra propiedad. |
Si todas están desaconsejadas, no invente una vuelta a ellas. Para desacuerdos o historia lea declaraciones completas y rangos. Ausencia en consulta directa puede deberse al filtro.
No. Rango y tiempo son mecanismos distintos. Compruebe fecha y criterio de rango; pueden coexistir varias preferidas.
Documentación consultada el .
REFERENCIAS DOCUMENTADAS
Una respuesta JSON contiene más que un valor. El extracto real corresponde a la densidad finlandesa de 2023. Su cabecera indica una actualización WDI el 8 de octubre de 2026; esta copia se obtuvo el 23 de octubre. Las tres fechas responden a preguntas distintas.
| Referencia | Valor o forma | Qué identifica |
|---|---|---|
| date | 2023 | Año de observación. No pasa a ser 2026 porque se haya consultado en 2026. |
| lastupdated | 2026-10-08 | Fecha de actualización indicada en la cabecera. No acredita por sí sola una revisión de este valor concreto. |
| extracted | 2026-10-23 | Fecha de creación del extracto local; no sustituye al período observado ni a la fecha de la fuente. |
| unit | "" | El campo unit está vacío. La definición de EN.POP.DNST especifica personas por km² de tierra: vacío no significa adimensional. |
| decimal / value | 0 / 18.3705454665088 | decimal vale cero aunque value contiene decimales. Conserve el valor recibido; no interprete ese campo como margen de error. |
| pages / total | 1 / 4 | Las cuatro observaciones caben en una página. Otra consulta puede estar paginada: compruebe pages y total antes de considerar completa la recopilación. |
https://api.worldbank.org/v2/country/FRA;DEU;ESP;FIN/indicator/EN.POP.DNST?date=2023&format=json&per_page=100
[
{
"page": 1,
"pages": 1,
"per_page": 100,
"total": 4,
"sourceid": "2",
"lastupdated": "2026-10-08"
},
[
{
"indicator": {
"id": "EN.POP.DNST",
"value": "Population density (people per sq. km of land area)"
},
"country": {
"id": "FI",
"value": "Finland"
},
"countryiso3code": "FIN",
"date": "2023",
"value": 18.3705454665088,
"unit": "",
"obs_status": "",
"decimal": 0
}
]
]Es una copia fechada de la API, sin actualización automática al cargar la página. Compartir código de país no prueba una cobertura territorial idéntica. Para reproducir el análisis, conserve consulta, definiciones y valores ausentes; no transforme null en cero.
Documentación consultada el .
REFERENCIAS DOCUMENTADAS
Una lista de parámetros es una secuencia ordenada de pares nombre-valor. Puede repetir el mismo nombre. La herramienta aplica application/x-www-form-urlencoded mediante URLSearchParams a dos valores de una línea y relee el resultado; no envía ningún formulario.
| Referencia | Valor o forma | Qué identifica |
|---|---|---|
| U+0020 | + | Un espacio U+0020 se serializa como + en este formato. No es una regla universal para todos los componentes de una URL. |
| + | %2B | Un signo + perteneciente al valor se convierte en %2B. Pegar C++ directamente en una cadena ya codificada haría interpretar sus dos signos como espacios. |
| & | %26 | Un & dentro del valor se convierte en %26 y no introduce otro parámetro. |
| = | %3D | Un = dentro del valor se convierte en %3D; el separador estructural entre nombre y valor sigue siendo =. |
| été | %C3%A9t%C3%A9 | Los caracteres no ASCII se codifican a partir de UTF-8. Los escapes representan bytes, no una cantidad de letras visibles. |
| append / get / getAll / set | ordered pairs | append conserva otra aparición. get devuelve el primer valor; getAll devuelve todos en orden. set reemplaza el primero y elimina las demás apariciones de ese nombre. |
Dos valores de demostración calculados en esta página.
Dos pares conservados en su orden.
tag=C%2B%2B+%26+IA&tag=%C3%A9t%C3%A9
["C++ & IA","été"]
"C++ & IA"
Codificar no es cifrar ni sanear HTML. Esta demostración no simula la selección de controles, archivos multipart ni la normalización de saltos de línea del formulario. El servidor debe definir cómo tratar parámetros repetidos; convertirlos demasiado pronto en objeto puede perder valores.
Documentación consultada el .
No. Revise cuerpo, filtros, total y páginas.
No. Elija un alcance útil y documentado.
Compara bytes conservados. Método y calidad exigen sus propios controles.
Conservar la última etapa confirmada, los parámetros y las referencias de continuación. La recuperación debe comprobar las duplicidades y posibles cambios de los datos en lugar de suponer una simple adición de las respuestas.
REFERENCIAS DOCUMENTADAS
Dos personas pueden leer una versión y enviar correcciones distintas. Una precondición permite rechazar una escritura basada en una representación anterior. Los casos son ficticios: v1 y v2 son etiquetas didácticas, no observaciones de un servicio.
Lectura → cambio concurrente → escritura rechazada: ejemplo ficticio.
| Referencia | Valor o forma | Qué identifica |
|---|---|---|
| PUT · If-Match: "v1" | ETag: "v2" → 412 | El documento cambió después de su lectura. La comparación fuerte falla para este PUT: no sustituir la versión actual. Leerla de nuevo y revisar las diferencias. |
| PUT · If-Match: "v2" | ETag: "v2" → ✓ | Las etiquetas fuertes coinciden: esta precondición permite continuar. No garantiza una respuesta 200 ni superar los demás controles. |
| PUT · If-Match: W/"v2" | ETag: "v2" → 412 | El texto opaco coincide, pero una etiqueta es débil. If-Match exige comparación fuerte y falla. Eliminar W/ en el cliente no crea un validador fuerte. |
| PUT · If-None-Match: * | Presente → 412 / Ausente → ✓ | En una escritura, el asterisco exige que no exista representación actual. Si existe, la condición falla; si no existe, el tratamiento puede continuar. |
| GET · If-None-Match: W/"v2" | ETag: "v2" → 304 | Con GET o HEAD, If-None-Match usa comparación débil. Una coincidencia conduce a 304: reutilizar la copia guardada sin recibir otro cuerpo. |
| 428 | Precondition Required | El servidor exige una petición condicional. La ausencia de condición difiere de 412, que indica una condición falsa. Una respuesta 428 no debe almacenarse en caché. |
Cambie método, estado y condición. Introduzca una etiqueta entre comillas, una lista separada por comas o * solo. La evaluación se realiza en su navegador. Con * o una representación ausente, no se usa el ETag actual.
412: condición falsa. No ejecutar la operación solicitada.
Simulación didáctica local: no se envían peticiones API ni se guardan datos.
Condición satisfecha: continuar con los demás controles y el tratamiento normal. No se deduce un estado de éxito.412: condición falsa. No ejecutar la operación solicitada.304: condición falsa para GET/HEAD. Reutilizar la copia guardada.Sintaxis inválida: use etiquetas HTTP entre comillas o * solo. Si existe una representación, el ETag actual debe ser una sola etiqueta.El ejercicio evalúa una sola precondición antes de actuar. Supone una petición aceptable en los demás aspectos y excluye el caso especial de una operación ya completada. Siguen siendo necesarios autenticación, autorización, validación y reglas de negocio. Para evitar sobrescrituras, la API debe comprobar y aplicar el cambio de forma atómica.
Documentación consultada el .
PROFUNDIZACIÓN / PRÁCTICA
Una API proporciona datos útiles, pero el resultado depende de la configuración y la página. La colección debe conservar la solicitud completa y las condiciones necesarias para comprender la respuesta.
Actualizado el .
Relever URL, parámetros, estado, formato y página. Controlar los filtros, los límites de volumen y los errores reenviados sin exponer secretos en los periódicos.
Una respuesta exitosa puede contener sólo una página de resultados. Repetir la solicitud más tarde puede proporcionar un estado diferente si los datos han cambiado.
El diario de recopilación combina solicitud, fecha, respuesta conservada, cobertura y límite. Determina cómo recuperar o comprobar la extracción.