Como personas, nos comunicamos con los demás de diferentes maneras. Realizamos conversaciones verbales cara a cara, comunicación escrita a través de mensajes de texto o cartas, y comunicación no verbal con nuestro lenguaje corporal. Utilizando cualquier canal de comunicación, el mensaje pasa del remitente al destinatario y viceversa. Al igual que con la comunicación interpersonal, las redes informáticas necesitan una forma de pasar datos del remitente al destinatario.
En este artículo, examinaremos cómo se transfieren los datos a través de Internet, centrándonos en las cargas útiles bajo la API. Primero, definiremos claramente la relación carga-carga. A continuación, veremos los diferentes formatos de comunicación utilizados dentro de la carga útil en la API. Empecemos.
¿Qué es la carga útil en la API?
La tecnología avanza más rápido que nunca. De hecho, las nuevas tecnologías se lanzan diariamente. Por ejemplo, uno de los aviones más rápidos del mundo es el jet X3 de la NASA, con una velocidad máxima de 7,000 millas por hora.
Definitivamente hemos recorrido un largo camino desde que viajamos a caballo y en carreta. Hoy en día, es difícil imaginar un mundo sin redes informáticas entre bastidores. Pero, ¿alguna vez te has preguntado cómo se transfiere la información de una red a otra? La forma en que pasamos esta información es a través de la carga útil en la API. La carga útil son datos que viajan a través de una red informática. Veamos más esta pregunta.
Carga útil en la revisión de la API
Cuando los datos se envían a través de Internet, escupen dos piezas de información: sobrecarga y carga útil. Los datos genéricos son un identificador que se utiliza para mostrar el origen o el destino de la carga útil. Como solo se usa en el proceso de transmisión, la información general se elimina de la vista una vez que llega a su destino.
¿Qué es la carga útil en la API?
La carga útil de la API son los datos que desea transportar al servidor cuando envía la solicitud de la API. En pocas palabras, este es el cuerpo de su solicitud HTTP y su mensaje de respuesta.
Para entenderlo mejor, imagina enviar un mensaje de «Hola» y etiquetarlo con «msg» (abreviatura de mensaje). Hello se denomina carga útil y msg se denomina carga útil. Una vez que la carga y la carga útil han llegado a su destino, los únicos datos que se pueden mostrar son «Hola». La etiqueta «msg» se utiliza con fines internos únicamente para identificar sus datos.
La carga útil de la API se puede enviar o recibir en varios formatos, como JSON o XML. En la cadena de consulta, la carga útil generalmente se puede identificar con las llaves «{}».
Carga útil en el ejemplo de la API
La carga útil es la información básica en la carga útil que envía o recibe del servidor. A continuación se muestra un ejemplo de una carga útil JSON en la API.
POST /echo/post/json HTTP/1.1
Host: hubspot.com
Accept: application/json
Content-Type: application/json
Content-Length: 25{
"cid": 1,
"cname": "Hubspot",
}
En este ejemplo, los datos de carga útil son «1» y «Hubspot». La información restante es el encabezado/datos de marcado.
A continuación, considere este ejemplo de una carga útil XML.
<company>
<cid>1</cid>
<cname>Hubspot</cname>
</company>Aunque el formato es ligeramente diferente, la carga útil y los datos generales siguen siendo los mismos.
Formatos de carga
Hablaremos de tres tipos de formatos de carga:
- Formato de carga de solicitud de API
- Formato de carga útil de respuesta API OK
- El formato de la carga útil de la respuesta de la API falló
1. Formato de carga útil de solicitud de API
La solicitud de API de carga útil requiere dos parámetros y un subelemento:
2. Carga útil de respuesta API OK
Una respuesta de carga útil exitosa contendrá un parámetro y un subelemento:
- tipo de respuesta: el parámetro responseType debe establecerse en «OK».
- datos: Los datos pueden contener cero o más parámetros necesarios para la respuesta del método llamado.
{
"responseType": "OK",
"data": {
"companyName1": "value",
"companyName2": "value",
"companyName3": "value"
}
}
3. El formato de la carga útil con la respuesta de la API falló
La respuesta de carga útil fallida contendrá un parámetro y un hijo:
- tipo de respuesta: el parámetro responseType debe establecerse en «FAILED».
- mensajes: los mensajes pueden contener una matriz de mensajes de error nulos o más.
{
"responseType": "FAILED",
"messages": [
{
"message": ""
},
{
"message": ""
},
{
"message": ""
}
]
}Comunicación con la carga en API
En las redes informáticas, la comunicación consiste en enviar y recibir mensajes. El remitente debe dirigir correctamente el mensaje, mientras que el destinatario debe tener todos los recursos necesarios para procesar el mensaje.
Establecimos que la carga útil en la API se usa en el contexto del mensaje para distinguirlo de los datos generales. Se requieren datos generales para la correcta interpretación de la solicitud. Con esta información, ahora puede comprender mejor cómo se envían los mensajes a través de redes informáticas utilizando la carga útil en la API.
