Advertisement
  1. Code
  2. Creative Coding

Un vistazo a la API HTTP de WordPress: Una revisión

Scroll to top
Read Time: 5 min
This post is part of a series called A Look at the WordPress HTTP API.
A Look at the WordPress HTTP API: Saving Data From wp_remote_post

Spanish (Español) translation by Eva Collados Pascual (you can also view the original English article)

Uno de los desafíos que conlleva escribir una serie sobre una API, o incluso parte de una API, es que es difícil cubrir todos los aspectos de dicha API sin pasar demasiado tiempo buceando profundamente en una parte y al mismo tiempo tratar de no pasar simplemente por la parte superficial de cada API sin aportar suficiente información práctica.

Un buen ejemplo: A lo largo de la última serie, hemos estado echando un vistazo a la API HTTP de WordPress. Específicamente, hemos cubierto wp_remote_get y wp_remote_post, y hemos hecho un trabajo relativamente extenso con ambas funciones, incluyendo proyectos de construcción a modo de ejemplo.

Lo cierto es que todavía queda mucho terreno por cubrir respecto a la API HTTP de WordPress. En el futuro, podríamos hacer una serie avanzada sobre más aspectos de la API, pero por ahora, revisemos todo lo que hemos cubierto en esta serie.


Pero primero, ¿por qué un resumen?

Escribir una serie relativamente larga sobre un par de funciones puede cubrir mucho terreno. El problema de hacer esto es que si en algún momento en el futuro necesitas referirte a una parte, es posible que no recuerdes exactamente dónde se encontraba la información.

O, tal vez peor, es posible que tengas que recorrer a lo largo de una cantidad significativa de información con el fin de encontrar el único aspecto que necesitas para seguir progresando en tu trabajo.

Y claro, siempre puedes consultar el índice de la serie, pero con el fin de proporcionar algo similar a una "guía rápida", pensé que podría ser útil resumir los artículos, las funciones y las notas de alto nivel con respecto a la parte de la API que cubrimos en caso de que necesites una referencia para tu trabajo.

Por supuesto, ten en cuenta que siempre se puede ver la serie en su totalidad en la página de listado de la serie.


Solicitudes remotas

Antes de revisar cada una de las funciones, recuerda que una solicitud remota se puede definir como el proceso mediante el cual un servidor realiza una solicitud a otro servidor.

En términos generales, un servidor puede simplemente enviar datos a otro servidor que después hará algo con ellos (ya sea guardarlos, procesarlos, etc.), y opcionalmente podría enviar una respuesta de vuelta.

En términos generales, esto es una solicitud remota. Para obtener más información acerca de esta idea en particular, asegúrate de echar un vistazo a este artículo.


wp_remote_get

wp_remote_get es una función que forma parte de la API HTTP de WordPress que es responsable de realizar solicitudes GET.

La función acepta:

  • Una dirección URL a la cual se realiza la solicitud
  • La matriz de argumentos que se enviarán junto con la solicitud

Si eres el principal responsable de recuperar información del servidor, entonces esta es la función que querrás usar.

En segundo lugar, si necesitas algo más que una dirección URL o más control sobre la solicitud que es enviada, puedes revisar este artículo para consultar todos los argumentos que acepta.

¿Cómo funciona esto?

A continuación en la serie, construimos un plugin real que aprovecha wp_remote_get para que podamos recuperar el número de seguidores de una cuenta de Twitter determinada, así como el último tweet enviado desde dicha cuenta.

El propósito principal de este artículo y esta demostración era ofrecer un ejemplo práctico de cómo utilizar wp_remote_get en un entorno del "mundo real". Para obtener el código fuente completo de la funcional demostración, asegúrate de revisar el artículo asociado.

¿Qué se está devolviendo?

Debido a que wp_remote_get se centra en recuperar información, tiene todo el sentido que esperemos una respuesta, ¿verdad? En el artículo final que cubre wp_remote_get, analizamos qué se devuelve exactamente del servidor y cómo lo formatea WordPress para que nosotros lo usemos.

Si, durante el transcurso de tu trabajo, tienes dificultades para descifrar qué es exactamente lo que se está devolviendo del servidor (o por qué no funciona como se esperaba), entonces este es el artículo que debe revisar.


wp_remote_post

Así como wp_remote_get es responsable de realizar solicitudes GET, wp_remote_post es responsable de realizar solicitudes POST.

Al igual que con wp_remote_get, wp_remote_post acepta los mismos argumentos:

  • La dirección URL a la que se realiza la solicitud
  • Una serie de argumentos que ayudan a adaptar la solicitud al servidor

Pero hay una diferencia fundamental en el propósito de esta función y la que vimos antes. La diferencia es lo que sucede cuando se completa la solicitud.

Así como wp_remote_get se utiliza principalmente para recuperar datos, wp_remote_post se utiliza para enviar datos a través del cable para ser procesados, podría darse el caso de que nunca se envíe una respuesta de vuelta.

Para un sondeo inicial de esta función en concreto, lo que acepta incluyendo la lista avanzada de argumentos, revisa este artículo.

¿Cómo funciona esto?

Al igual que hicimos con wp_remote_get, creamos un plugin para demostrar cómo funciona wp_remote_post dentro del contexto más amplio de un tema de WordPress.

Aunque el plugin está como referencia en GitHub, hemos visto toda la primera versión del plugin en el siguiente artículo. Específicamente, cubrimos cómo hacer que la solicitud a un script sea responsable de recibir datos de $_POST y luego cómo puedes formatear y devolver una respuesta al invocador.

¿Qué se está devolviendo?

En el artículo final de la serie, completamos el plugin usando LESS para darle al plugin un aspecto y una sensación un poco más agradables, y lo redondeamos para que guarde realmente algunos de los datos de respuesta a la base de datos solo para dar una idea de cómo se puede lograr esto.


Conclusión

Los artículos recopilatorios son un nuevo territorio, para mí, al menos, ya que históricamente he dejado que mis series se extiendan por su cuenta, pero pensé que sería una buena idea proporcionar esta referencia teniendo en cuenta que hemos cubierto mucho terreno en la serie.

Para reiterar:

Dicho esto, avísame si prefieres artículos resumidos o no. Como mencioné, esto es algo que normalmente no hago, pero si os ayuda proporcionándoos un punto de referencia, estaré feliz de seguir creándolos para futuras series.

Advertisement
Did you find this post useful?
Want a weekly email summary?
Subscribe below and we’ll send you a weekly email summary of all new Code tutorials. Never miss out on learning about the next big thing.
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.