API de WordPress: qué son y cómo usarlas

La API REST JSON de WordPress ha generado un gran revuelo en la comunidad de WordPress, ofreciendo nuevas posibilidades tanto para desarrolladores como para creadores de contenido.

Si bien puede parecer complejo, comprender términos clave como JSON, REST y API puede simplificar la forma en que interactúa con las amplias capacidades de WordPress.

¿Qué es una API?

API significa "interfaz de programación de aplicaciones", que es esencialmente un conjunto de instrucciones y estándares de programación que permiten que diferentes aplicaciones de software se comuniquen entre sí.

Imagine una aplicación de software dando instrucciones a otra: una API es el conjunto de reglas acordadas que gobiernan esta interacción. Cuando una pieza de software envía instrucciones a otra, la API facilita la acción o proporciona la información necesaria.

Puede pensar en una API como la "interfaz de usuario" entre dos sistemas de software, que maneja la comunicación de datos y la ejecución de tareas, pero es invisible para el usuario final.

Ejemplos de API

Tener acceso a una API es fantástico cuando desarrollas aplicaciones web. Cuando una API se lanza al público, significa que los desarrolladores crearon soluciones impulsadas por el servicio del software. Muchas veces, eliminan la necesidad de reinventar la rueda para muchas tareas, puesto que ya han sido creadas.

Un gran ejemplo de API es Amazon. Amazon lanzó su API para que los desarrolladores puedan acceder fácilmente a los productos y su información. Tener acceso a esto facilita publicar enlaces a productos en Amazon, con precios actualizados y la opción de comprar.

Otro ejemplo de API que interactúan 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 está correcto, la aplicación remota envía una respuesta al sitio web de boletos diciendo que está bien continuar, momento en el cual habrá comprado los boletos exitosamente. Cuando todo esto sucede, solo ves una interfaz, que es el sitio web de entradas. Es un proceso fluido; Detrás de escena, muchas aplicaciones trabajan juntas usando API, pero usted, como usuario, no se da cuenta cuando las tareas se pasan de una aplicación a otra.

API y WordPress

Amazon y la compra de entradas son excelentes ejemplos de cómo funcionan juntas las API, pero ¿cómo se aplica esto a WordPress?

Bueno, se aplican todas las mismas ideas. Con la API de WordPress, puede insertar y extraer datos dentro y fuera de WordPress.

La API es una herramienta clave que los desarrolladores pueden utilizar para compartir fácilmente datos desde su sitio web de WordPress con otros sitios web o aplicaciones. Específicamente, esta API le permite realizar acciones create , read , update y delete (CRUD) en 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: REST se refiere al estilo arquitectónico de una API. REST significa Transferencia de Estado Representacional.

¿Recuerda que mencionamos que una API proporciona 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 de comunicación liviano, lo que ahorra ancho de banda. La API REST JSON de WordPress hace precisamente esto, lo que la convierte en 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 la cual extraerlos. Aquí es donde entra en juego JSON. JSON significa notación de objetos JavaScript.

JSON es fácil de leer y comprender tanto para humanos como para máquinas. Es la manera perfecta de almacenar información de una manera organizada y de fácil acceso. Debido a que JSON es de fácil acceso, lo convierte en una excelente opción para crear API REST y es la solución perfecta para la API REST JSON de WordPress.

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

[javascript]
{"empleados":[
{“nombre”:”Jane”, “apellido”:”Smith”},
{“nombre”:”Anna”, “apellido”:”Olsen”},
{“nombre”:”Josh”, “apellido”:”Jones”}
]}

[/javascript]

Formato JSON en WordPress

JSON no se escribe solo, pero no te preocupes, no tienes que crear manualmente el archivo JSON. Hay complementos que pueden crearlo por usted. Con una de estas herramientas, los datos del sitio estarán en el formato correcto, incluidos usuarios, publicaciones, páginas, taxonomías y más.

Usando la API REST JSON

El uso de la API se explica por sí mismo; obtendrá los datos de su sitio en formato JSON simple. Y si tiene un 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 busca "desarrollo", obtendrá los resultados con la solicitud GET /wp-json/wp/v2/posts?search=development .

Solicitud de publicación

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 el ID 10. Todo lo que tiene que hacer es enviar una solicitud POST a /wp-json/wp/v2/users/10 .

Para probar esto, le recomendamos utilizar 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 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 Backbone. Esto permite a los desarrolladores de complementos y temas ponerse 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 esto para los desarrolladores de WordPress?

Con la disponibilidad de la API de WordPress, han aumentado las nuevas formas de utilizarla y seguirán haciéndolo a medida que gane popularidad. La API de WordPress puede mejorar casi cualquier funcionalidad existente de WordPress que dependa de Javascript. A continuación se muestran algunos ejemplos:

• validación/envío de formulario
• 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 desde un sitio de WordPress completamente independiente. Además de mostrar contenido, el contenido también se puede actualizar de forma más sencilla y eficaz.

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.