Un método que expone, mediante una interfaz de programación documentada (API), la funcionalidad, el contenido y los metadatos descriptivos de una biblioteca o repositorio para que sistemas externos puedan consultar, recuperar o manipular recursos de forma automatizada, repetible y controlada.

Principio

Una API formaliza un contrato programático: peticiones estructuradas devuelven respuestas estructuradas bajo restricciones definidas (endpoints, parámetros, autenticación, límites de frecuencia), posibilitando integraciones estables y la reutilización automatizada sin necesidad de raspado masivo.

Demostración

Escenario ilustrativo: un servicio de descubrimiento realiza consultas autenticadas a un endpoint del repositorio para registros bibliográficos de una materia; el repositorio devuelve registros en JSON y un cursor con marca temporal, permitiendo al servicio ingerir solo registros modificados y conservar la procedencia de metadatos.

Aplicación incorrecta

Tratar la API como si fuera una copia íntegra de la colección (por ejemplo, asumir que la API suministra todo el contenido de preservación) es un error semántico: una API expone un subconjunto y una representación definidos por contrato, no necesariamente la totalidad de los holdings o los objetos de preservación.

Consecuencia

Usada correctamente, la API posibilita interoperabilidad, sincronización selectiva y flujos de actualización previsibles; también genera dependencias operativas respecto del contrato del proveedor, versionado y políticas de acceso que afectan disponibilidad e integración a largo plazo.

Inversión

Si falta una API, está obsoleta, muy limitada o restringida para contenido de preservación, puede ser necesario el acceso programático por otros medios (exportaciones masivas planificadas, transferencia de datos acordada o recolección selectiva); una API no sustituye la necesidad de estrategias de preservación.

Límite

Claramente dentro: endpoints REST/GraphQL/OAI documentados que retornan metadatos estructurados y aceptan consultas. Caso límite: un feed legible por máquina proporcionado por la institución sin endpoints de consulta (útil pero no una API completa). Claramente fuera: descarga manual de archivos vía interfaz web o scraping HTML ad hoc sin interfaz documentada.

Tensión semántica

Control ↔ Accesibilidad — las APIs permiten al proveedor controlar representaciones, reglas de acceso y cadencia de cambios mientras habilitan la integración externa; esa necesidad de control puede limitar la apertura y la descubribilidad.

Síntesis

El acceso por API es un contrato programático: sustituye la recuperación ad hoc por interacciones definidas y automatizables que mejoran la estabilidad y la interoperabilidad, pero desplaza la gestión hacia el contrato y las políticas del proveedor.