Es posible que haya oído hablar de la API REST JSON de WordPress. ¡Esta es una gran noticia para los usuarios de WordPress y motivo de celebración!

JSON, REST, API: sin embargo, esto es mucha jerga para un nombre, así que analicemos todo.

¿Qué es una API?

API significa "interfaz de programación de aplicaciones", que es un conjunto de instrucciones y estándares de programación para acceder a una aplicación de software basada en la web o una herramienta web. Imagine el "software uno" que está dando instrucciones al "software dos". Una API es un acuerdo entre los dos y las líneas de comunicación están abiertas. Básicamente, lo que se dicen entre ellos es algo así como "cuando me das una instrucción, realizaré la acción o devolveré la información correcta".

A medida que buscamos en la web y usamos varias soluciones de software, estamos acostumbrados a las interfaces de usuario con diseños, botones y gráficos específicos con los que interactuamos para completar las tareas deseadas. Todo esto es inútil para una máquina porque lo único que les importa son los datos y lo que necesitan hacer y cómo interactúan con ellos. Una API es la alternativa del software a la "interfaz de usuario", dando instrucciones a un segundo software sobre cómo obtener datos y otras tareas específicas. Son completamente invisibles para los usuarios que utilizan la aplicación web y son simplemente una interfaz de software a software.

Ejemplos de API

Tener acceso a una API es increíble cuando estás desarrollando aplicaciones web. Cuando una API se lanza al público, significa que los desarrolladores crearon soluciones que funcionan con el servicio del software. A menudo, eliminan la necesidad de reinventar la rueda para muchas tareas, ya que ya se han creado.

Un gran ejemplo de una API es Amazon. Amazon lanzó su API para que los desarrolladores puedan tener fácil acceso a los productos y su información. Tener acceso a esto facilita la publicación de enlaces a productos en Amazon, con precios actualizados y la opción de compra.

Otro ejemplo de la interacción de las API sería la compra de entradas para conciertos. Para comprar boletos oficialmente, debe ingresar la información de su tarjeta de crédito. Se utiliza una API para enviar la información de su tarjeta de crédito a una aplicación remota, que luego verifica que la información de la tarjeta de crédito sea correcta. Una vez que todo se verifica, la aplicación remota envía una respuesta al sitio web de boletos diciendo que está bien continuar, momento en el que ha comprado los boletos con éxito. Cuando todo esto sucede, solo ve una interfaz, que es el sitio web de boletos. Es un proceso continuo; Detrás de escena, muchas aplicaciones trabajan juntas usando API, pero usted, como usuario, no se da cuenta cuando las tareas se transfieren de una aplicación a otra.

API y WordPress

Amazon y las compras de boletos son excelentes ejemplos de cómo las API funcionan juntas, pero ¿cómo se aplica esto a WordPress?
Bueno, se aplican todas las mismas ideas. Con la API de WordPress, puede enviar y extraer datos de WordPress.

La API es una herramienta clave que los desarrolladores pueden usar para compartir fácilmente datos de su sitio web de WordPress con otros sitios web o aplicaciones. Específicamente, esta API le permite realizar acciones de create , read , update y delete (CRUD) en el contenido de WordPress. Algunos ejemplos de los tipos de contenido son:

• Publicaciones
• Tipos de publicaciones personalizadas
• Paginas
• Taxonomías
• Usuarios
• Medios de comunicación

¿Qué significa DESCANSO?

Aquí no hay siestas ni ronquidos, pero REST se refiere al estilo arquitectónico de una API. REST significa Transferencia de Estado Representacional. ¿Recuerdas que mencionamos que una API brinda los detalles de comunicación para que los programas puedan comunicarse entre sí? Las API REST están diseñadas de tal manera que proporcionan un método ligero de comunicación, lo que ahorra ancho de banda. La API REST JSON de WordPress hace exactamente esto, por lo que es una excelente opción cuando hay un gran volumen de datos.

Acabamos de arañar la superficie de REST; Si desea obtener más información, consulte este útil tutorial de REST.

formato JSON

Para acceder a los datos, necesitamos una fuente de donde extraer. Aquí es donde entra en juego JSON. JSON significa Notación de objetos de JavaScript. JSON es fácil de leer y comprender tanto para humanos como para máquinas. Es la forma perfecta de almacenar información de forma organizada y de fácil acceso. Debido a que JSON es tan fácil de acceder, esto lo hace ideal para crear API REST y es la solución perfecta para la API REST JSON de WordPress.

Aquí hay una idea básica de cómo se ve el formato JSON:

{"employees":[
	{"firstName":"Jane", "lastName":"Smith"},
	{"firstName":"Anna", "lastName":"Olsen"},
	{"firstName":"Josh", "lastName":"Jones"}
]}

Formato JSON en WordPress

JSON no solo se escribe solo, pero no se preocupe, no tiene que crear manualmente el archivo JSON. Hay un gran complemento que lo crea para ti. Con esta herramienta, los datos del sitio estarán en el formato correcto, incluidos usuarios, publicaciones, páginas, taxonomías y más. El complemento se puede encontrar aquí. Además, hay alguna documentación útil que será valiosa cuando comience.

Uso de la API REST de JSON

El uso de la API se explica por sí mismo; obtendrá los datos de su sitio en formato JSON simple. Y si tiene el complemento instalado, puede jugar viendo las publicaciones de su sitio en forma de datos.

Recuperar o actualizar datos es tan simple como enviar una solicitud HTTP. HTTP es un protocolo de solicitud/respuesta. Primero, envía una solicitud de datos y luego los datos se devuelven como respuesta.

OBTENER método

El método GET se utiliza para recuperar información y no tiene ningún efecto sobre los datos. Simplemente envíe una solicitud GET a /wp-json/wp/v2/posts . ¿Quieres buscar algo? Por ejemplo, si está buscando "desarrollo", obtendrá los resultados con la solicitud GET /wp-json/wp/v2/posts?search=development .

Solicitud POST

Se utiliza una solicitud POST para enviar datos. Con las capacidades de la nueva API, por ejemplo, podría actualizar un usuario. Digamos que desea actualizar el usuario con la ID de 10. Todo lo que tiene que hacer es enviar una solicitud POST a /wp-json/wp/v2/users/10 .

Para probar esto, recomiendo usar Postman, una extensión de Google Chrome.

Más Javascript en la mezcla

Backbone.js y API

Backbone.js es una excelente manera de trabajar con la API porque es un marco diseñado para trabajar con API REST. La API de WordPress incluye una API de Javascript fácil de usar basada en modelos de Backbone. Esto permite que los desarrolladores de complementos y temas se pongan en marcha sin un esfuerzo y un conocimiento muy profundos sobre los detalles de la conexión. Hay mucho más, pero Backbone brinda estructura a las aplicaciones web al proporcionar modelos, colecciones y vistas, y lo conecta todo a la API de WordPress a través de una interfaz REST JSON.

¿Qué significa todo esto para los desarrolladores de WordPress?

Con la disponibilidad de la API de WordPress, han aumentado las nuevas formas de utilizarla y seguirá haciéndolo a medida que gane popularidad. La API de WordPress puede mejorar casi cualquier funcionalidad existente de WordPress que se base en Javascript. Aquí están algunos ejemplos:

• formulario de validación/envío
• Temas o complementos de Backbone.js
• desplazamiento infinito

También es una excelente manera de mostrar contenido de otras fuentes. Ahora, es fácil mostrar contenido de un sitio individual dentro de una configuración multisitio. También es posible mostrar contenido de un sitio de WordPress completamente separado. Además de mostrar contenido, el contenido también se puede actualizar.

Ahora que hemos repasado parte de la terminología básica, sabemos que JSON es la notación, REST es el estilo arquitectónico y API es la interfaz que componen. Conocer los conceptos básicos de la API y sus capacidades le asegurará un buen comienzo cuando explore las nuevas posibilidades con la API de WordPress.