Evidency / Blog / API e integración: definiciones de los conceptos clave

API e integración: definiciones de los conceptos clave

Tiempo de lectura: 3 min

Fecha de modificación: 27 septiembre 2026

En los sistemas de prueba digital (sellado de tiempo, sellado electrónico, archivo electrónico y registro de eventos), la API constituye con frecuencia el punto de enlace entre una aplicación de negocio y un servicio de confianza. Formaliza las condiciones del intercambio (solicitudes, respuestas, códigos de estado y mecanismos de autenticación) y determina la trazabilidad técnica de las operaciones.

Índice

¿Qué es una API?

Una API (Application Programming Interface) es una interfaz de programación que permite a un programa llamar a funciones expuestas por otro programa según unas reglas publicadas (métodos, parámetros, formatos, códigos de respuesta). En el caso más habitual (API web), estas comunicaciones se basan en HTTP: un cliente envía una solicitud y el servidor devuelve una respuesta, con una semántica estandarizada (métodos, códigos de estado, encabezados).

¿Qué es una API REST?

Una API REST es una API web diseñada según el estilo de arquitectura REST (Representational State Transfer), descrito por Roy Fielding: las interacciones se centran en recursos identificados, que se manipulan a través de representaciones, mediante mensajes autodescriptivos, en un modelo sin estado (sin estado de sesión del lado del servidor, en el sentido de REST).

En la práctica, el término «REST» se utiliza a menudo para referirse a las API HTTP que estructuran sus URL en torno a recursos y utilizan de forma coherente los métodos y los códigos de estado HTTP.

¿Qué es un punto final?

Un punto final es un punto de acceso concreto de una API: normalmente una combinación de (i) una URL (o ruta), (ii) un método HTTP (GET, POST, etc.) y (iii) un comportamiento esperado (parámetros, esquema de respuesta, posibles errores). El conjunto de puntos finales constituye la API. La terminología (métodos, estados) se inscribe en la semántica HTTP.

¿Qué es un webhook?

Un webhook es un mecanismo de notificación «push»: en lugar de que el cliente consulte la API para saber si se ha producido un evento, el servidor accede a una URL facilitada por el cliente (callback) para comunicarle dicho evento. En una cadena de pruebas, el webhook se utiliza con frecuencia para notificar la finalización de un proceso (por ejemplo: «token disponible», «documento sellado», «archivo completado»), lo que implica garantizar la seguridad del emisor, la recepción y el registro de la llamada.

¿Qué es la carga útil?

La carga útil (payload) es la parte de un mensaje que contiene los datos de negocio transmitidos (por ejemplo, un JSON, un archivo binario o una huella digital). En HTTP, la carga útil suele estar contenida en el cuerpo del mensaje (message body), mientras que los encabezados (headers) describen, entre otras cosas, el tipo de contenido, la codificación, la autenticación, etc.

En un sistema de pruebas, lo fundamental es identificar con precisión qué forma parte de la carga útil (datos, hash, metadatos) y qué forma parte de las cabeceras (contexto de transporte, seguridad), con el fin de evitar ambigüedades durante una verificación.

¿Qué es la autenticación?

La autenticación es el mecanismo mediante el cual un sistema comprueba que un solicitante es efectivamente quien dice ser (por ejemplo, mediante una clave secreta, un certificado o un token). En HTTP, la autenticación se lleva a cabo, en particular, mediante los campos «Authorization» y «WWW-Authenticate», así como mediante los esquemas asociados.

En una API de confianza digital, la autenticación se combina con la autorización (derechos) y la limitación de uso (cuotas, medidas contra el abuso), ya que las vulnerabilidades de las API suelen deberse a un control de acceso mal aplicado o incompleto (guía de referencia de OWASP).

¿Qué es el TLS?

TLS (Transport Layer Security) es el protocolo de seguridad que permite que las aplicaciones cliente/servidor se comuniquen reduciendo los riesgos de interceptación, alteración y falsificación de los mensajes en la red. Constituye la base del protocolo HTTPS (y, por lo tanto, de la mayoría de las API web).

El TLS, por sí solo, «no constituye una prueba»; lo que hace es garantizar la seguridad del transporte. El valor probatorio de un sistema se basa, a su vez, en los mecanismos de aplicación (integridad de los objetos generados, trazabilidad, conservación y verificación), pero el TLS es un requisito técnico previo para limitar las impugnaciones relacionadas con el canal de transmisión.

  • Camille Lehur Evidency

    Camille es Digital Marketing Manager en Evidency. Con más de 10 años de experiencia, está especializada en gestión de contenidos y adquisición de tráfico.