La guía completa de los fundamentos de API REST de WordPress |
Posted: July 15, 2020 |
La API REST de WordPress está en proceso de cambio de Wordpress. Es posible que no lo haya sentido, en tanto que una gran parte de ella está bajo el capó, pero las implicaciones de API REST marcan gran diferencia para el futuro de WordPress, tanto en términos de su base de código como de sus usos. Si no ha trabajado con API REST de Wordpress, es posible que se pregunte qué es. Así que vamos a iniciar mirando lo que es API de REST. ¿Qué es API de REST de WordPress?API REST de Wordpress es una interfaz quepueden usar para acceder a WP desde fuera de la propia instalación de Wordpress. Se accede a él utilizando JavaScript, lo que quiere decir que se puede usar para crear sitios web y aplicaciones interactivas. REST significa Representational State Transfer y API significa Application Programming Interfaz. Echemos un vistazo a lo que significa cada uno de ellos. ¿Qué es una Interfaz de Programación de Aplicaciones (API)?Una Interfaz de Programación de Aplicaciones, o API, secomo: «Una interfaz o bien protocolo de comunicación entre un cliente del servicio y un servidor para facilitar la construcción de software del lado del cliente del servicio.» Si no está familiarizado con las API, posiblemente eso no le asista mucho. En pocas palabras, una API es un conjunto de código que permite a un sistema interactuar (o bien «interfaz») con otro. Si alguna vez ha, ha empleado API de Google Maps, que permite que su lugar de Wordpress interactúe con Google Maps. Estos sistemas no precisan estar completamente separados. Wordpress ya tiene múltiples, para cosas como, configuraciones y. Estos pueden ser utilizados por los desarrolladores de plugins y temas para interactuar con el núcleo de WP y hacer que las cosas sucedan (como crear atajos y añadir pantallas de configuración al administrador de Wordpress). La diferencia con la API de REST es que deja que los sistemas fuera de la propia instalación de WP interactúen con Wordpress, que es donde entra en juego la una parte de REST. ¿Qué es la transferencia estatal de representación (REST)?Representational State Transfer, o REST, da estándares que los sistemas web pueden emplear para interaccionar entre sí. Sin REST, 2 sistemas no podrían entenderse entre sí y, en consecuencia, mandar datos de un lado a otro. Para que una aplicación sea, debe cumplir con cinco principios:
Todas estas limitaciones se refieren a páginas web y aplicaciones y rigen la manera en que una aplicación puede interactuar con la API. ¿Qué significa esto para WordPress?La combinación de REST y API quiere decir que API REST de Wordpress es un conjunto de código diseñado para hacer posible que otros sistemas interactúen con Wordpress y que está construido de una manera que asegura que estos sistemas se entiendan entre sí. Esto significa que un sitio de terceros o una aplicación móvil, por ejemplo, puede acceder a la, conseguir datos de ella y añadir datos a la misma. Sin embargo, hay una serie de implicaciones y usos para esto. Entendiendo API REST de WordPressAPI REST de WordPress fue desarrollada como respuesta a los cambios en la forma en que se desarrollan los sitios y las aplicaciones y a la necesidad de abrir Wordpress más extensamente. Fondo de API REST de WordPressAPI REST de WordPresscomo una parte del núcleo en la versión 4.7 en diciembre de 2016, mas ya estaba disponible como un plugin antes de esa fecha. Está diseñado para soportar una extensa gama de aplicaciones construidas sobre Wordpress y para convertir WordPress de una una plataforma de aplicaciones. Es usado extensamente por, cuya interfaz basada en JavaScript emplea API REST para interaccionar con la base de datos de WP. También es utilizado por la, que se convirtió en parte del núcleo en 2019. API REST amplía la gama de aplicaciones para las que se puede utilizar WP. Al paso que un sistema de gestión de contenidos destaca en la ejecución de un sitio web complejo, una plataforma de aplicaciones también se puede utilizar para impulsar aplicaciones de una sola página basadas en web o bien SPAs (si alguna vez ha usado, ha empleado uno de ellos). En estos, el contenido se actualiza cuando el usuario toma acción, en vez de cargar nuevas páginas. Debido a que emplea JavaScript (un lenguaje del lado del usuario) en lugar de(un lenguaje del lado del servidor), puede hacer que las cosas sucedan en el navegador del usuario sin enviar constantemente peticiones al servidor. Implicaciones para los usuarios y desarrolladores de WordPressSi usted es un usuario y/o desarrollador que trabaja con WordPress, API REST tiene una serie de implicaciones. Para los usuarios, estos incluyen:
Para los desarrolladores, hay implicaciones y posibilidades más amplias:
Con el tiempo, API REST de WordPress significará que la mayoría del núcleo de WordPress se escribirá en JavaScript y no en PHP. Si es un desarrollador de WordPress, esto significa que necesitará aprender JavaScript. ¿Cómo acceder a API REST de Wordpress?¿Cómo se accede a API REST de WordPress? Para acceder a WP-API REST, deberá acceder a su sitio a través de la línea de comandos. Con WordPress, esto tiene por nombre. Usted no hace nada de esto a través de sus pantallas de administración o bien accediendo directamente al código de su sitio. Echemos una ojeada a cómo iniciar. Acceso a WP-REST mediante WP-CLIWP-CLI es la interfaz de línea de comandos de WP. Le permite acceder y trabajar con WP a través de la interfaz de línea de comandos (CLI) de su PC. WP-CLI está preinstalado con todos y cada uno de los planes de hosting de Kinsta. Para acceder a la CLI, abra Terminal en un Mac o bien en Linux, o bien Símbolo del sistema en Windows. Terminal on Mac Para acceder a un sitio remoto, necesitapara acceder a él a través de WP-CLI (¿No puedes conectarte por SSH? Aprende a). Para acceder a un, es suficiente con usar la estructura de directorios adecuada desde la línea de comandos. Es una buena idea probar con API REST en un lugar de pruebas local antes de probarla en un sitio en vivo. Necesitará acceder específicamente a API REST de su lugar, de esta manera: A continuación, puede añadir elementos para acceder a ciertos tipos de datos, que analizaremos con más detalle en breve. Estos elementos se denominan puntos finales. AutenticaciónUna vez que haya accedido a su sitio, posiblemente tenga que pasar por un proceso de autenticación. Algunos endpoints son públicos y no requieren autenticación, mientras que otros sí. No estáaquí: API REST hace las cosas de forma un tanto diferente. Para poder autenticar su lugar a través de WP-CLI, necesitará instalar un complemento de autenticación. Para las instalaciones de desarrollo, el pluginhace el trabajo y es fácil de utilizar. Sin embargo, para sitios en vivo, debería utilizar una forma más robusta de autenticación como el complemento, que usa JSON Web Token y es más seguro. A continuación, puede utilizar la línea de comandos para acceder a los datos e incluir la autenticación. El siguiente ejemplo usa Los bocetos de mensajes no son información pública, por lo que precisa autenticación para acceder a ellos. Mas si está buscando datos que son públicos, no necesita autenticación. Así que para recobrar una lista de mensajes que han sido publicados, puede utilizar: Esto obtendría todos los mensajes publicados por el hecho de que son públicos. Descripción general de los comandos de API REST de WordPressUna vez que haya accedido a su lugar y sepa cómo emplear la autenticación (y, en verdad, si es necesario), tendrá que utilizar uno de una serie de comandos para interactuar con su lugar. Los comandos que necesitará utilizar son:
Echemos un vistazo a cada uno de ellos de ellos por separado. GETEl comando GET El commando Tenga en cuenta que no he incluido la senda completa a su sitio en la línea de arriba, puesto que ya ha accedido a ella utilizando WP-CLI. Una vez recuperados esos datos, puede emplearlos para informar al siguiente paso. Puede borrar uno de esos mensajes, editarlo o bien actualizarlo. Podría simplemente mandar mensajes a su aplicación web. Digamos que quiere ir a buscar el último artículo. Usaría esto: Hay una serie de argumentos que puede usar cuando trabaja con mensajes. Consulte elpara obtener más información. POSTEl comando POST Utilice Así que, por ejemplo, si desea crear un mensaje, empezará usando un comando Esto crearía un nuevo borrador vacío. A continuación, puede actualizar el mensaje usando un comando Con un comando Para añadir una página a su lugar, puede usar algo como esto: Esto crearía una página vacía de igual modo que crearía una entrada vacía. PUTEl commando PUT El comando Supongamos que tiene varios bocetos en su sitio web. Desea revisarlas y actualizar una para que se publique. Podrías empezar por obtener una lista de todos los mensajes de borrador: El sistema le dará una lista de todos y cada uno de los borradores actuales. Puede alterar el status de uno de ellos usando su ID: Esto accede a ese mensaje y le deja editarlo. A continuación, puede alterar su status utilizando el razonamiento de status: O bien, puede añadir contenido al mensaje y publicarlo: El servidor devolverá un estado de DELETEEl comando DELETE El comando ¿Cansado de probar problemas con su lugar de WP? Obtenga el mejor y más rápido soporte de alojamiento web con Kinsta! Así que si quisiese mover el mensaje que acaba de crear a la papelera, usarías esto: Sin embargo, si quisiera pasar por alto la papelera y quitarla de manera permanente, usaría el argumento Esto elimina de manera permanente el mensaje sin opción de deshacerlo, por lo que se debe utilizar con precaución. ¿Cuándo no emplear API REST de WordPress?API REST de WordPress no siempre y en todo momento será el enfoque correcto para desarrollar un sitio o una aplicación. He aquí ciertas consideraciones que debe tener en cuenta ya antes de emplearlo para el desarrollo: CompatibilidadSi su aplicación se va a emplear en dispositivos que no ejecutan JavaScript o por usuarios que seguramente la tengan desactivada, no se ejecutará si está utilizando API REST. Un lugar WordPress codificado en PHP producirá HTML para que no sufra este inconveniente. Los dispositivos que no utilizan JavaScript son cada vez más raros, mas si está desarrollando específicamente para ellos, API REST no funcionará. Del mismo modo, si probablemente sus usuarios desactiven JavaScript, entonces trabajar con API REST causará inconvenientes. Algunos usuarios desactivan JavaScript en sus navegadores por razones de accesibilidad o seguridad. AccesibilidadLos sitios o bien aplicaciones desarrollados con JavaScript no siempre y en toda circunstancia son tan alcanzables como los que salen en código HTML. Esto se debe en gran medida a la manera en que se emplea JavaScript para entregar contenido dinámico que puede no marchar bien con los lectores de pantalla y puede crear problemas a las personas con deficiencias visuales o bien epilepsia fotosensible. Usar API REST para acceder a su sitio WP y a los datos de salida de una forma que esté diseñada para ser accesible quiere decir que puede superar estos problemas, mas merece la pena comprobar la accesibilidad de su lugar mientras lo está desarrollando. SEOLas aplicaciones de una sola página, que se actualizan habitualmente, a veces pueden causar. Esto es debido a que el contenido que no se entrega cuando se imprime por primera vez la página puede no ser indizado por los motores de búsqueda. están poniendo al día con el hecho de que muchos sitios web ahora tienen SPA y los están indexando adecuadamente. Mas vale la pena hacer unacompleta de cualquier sitio que desarrolle usando API REST. ¿Cómo desactivar la API de REST de WP?Si no desea que las aplicaciones puedan acceder a los datos de su sitio a través de API REST, puede desactivarla. Recuerde que los datos públicos pueden ser alcanzables para cualquier persona, no sólo para usted. Para ello, puede instalar el plugin. Esto desactiva la API REST para cualquiera que no haya empezado sesión en su lugar. Deshabilitar WP REST API plugin Alternativamente, puede agregar algún código al fichero de funciones de su tema o escribir su plugin. Es mejor escribir un plugin puesto que no es una funcionalidad específica del tema. En su plugin, añada sólo dos líneas: Esto deshabilitará absolutamente API REST para su lugar. Puede que tenga efectos secundarios para sus pantallas de administración, así que asegúrese de que todo marcha correctamente una vez que lo haya añadido. Aplicaciones del planeta real usando API REST de WordPressLa API REST presenta ciertas posibilidades interesantes para el futuro de Wordpress. Aquí hay algunos ejemplos de aplicaciones y sitios que usan API REST de WordPress para crear SPAs o para enlazar WP con otros sitios y tecnologías. WordPress.comWordPress.com Las pantallas de administración de Wordpress.com están construidas absolutamente usando API REST para proporcionar un SPA con el que los usuarios interactúan para dirigir su lugar. Esto hace que la comunicación entre la interfaz y el servidor sea dinámica y resulta en una interfaz fácil de utilizar que WordPress.org probablemente imitará con el tiempo. El Editor de Bloques (Gutenberg)El editor de Gutenberg También en las pantallas de administración de WordPress, mas esta vez también en Wordpress autohospedado, el editor de bloques de Gutenberg emplea API REST para comunicarse con su base de datos y crear bloques. Para que los tipos de mensajes funcionen con el editor Gutenberg, deben tener habilitada API REST. Lo que quiere decir que si está registrando uny usa Gutenberg, tendrá que añadir la siguiente línea para habilitar el editor de bloques para ese tipo de mensaje: Event EspressoEvent Espresso es un plugin de WordPress que deja a los usuarios organizar y promocionar acontecimientos. Utiliza API REST a fin de que los usuarios puedan acceder a los datos desde fuera de WordPress. Esto significa que puede crear aplicaciones móviles o SPAs para gestionar sus acontecimientos. UsTwoUsTwo es una agencia digital cuyo lugar fue construido utilizando API REST como una aplicación de una sola página. Esto combina un front-end construido usando React con un backend alimentado por WP (lectura sugerida:). El contenido de su página única es modular, con una estructura diferente a la de una página estándar de WordPress. Para que esto funcione, usan un plugin de creación de páginas adaptado que permite a su equipo añadir contenido modular al sitio. USA TodayUSA Today El sitio web defue reconstruido utilizando la integración de API REST WP con los sistemas y módulos existentes en el sitio. API REST permitió que el contenido del sitio fuera mandado a otros puntos de venta comoy Apple News, utilizando JSON. También escribieron un juego social en línea para su sección de deportes, construido utilizando JavaScript. La API REST de Wordpress abre muchas oportunidades dentro del ecosistema de Wordpress. Aprenda a sacarle el máximo provecho con esta guía en profundidad! 🔀⚙️ Haga clic para Tweet ResumenAPI REST de Wordpress presenta ciertos desafíos interesantes, pero también ocasiones interesantes tanto para los usuarios de Wordpress para los desarrolladores. Es ely probablemente cambie radicalmente la manera en que desarrollamos con Wordpress y la manera en que lo usamos. ¿Cuál es su opinión sobre API REST? ¿Lo ha utilizado para ciertos de sus proyectos? Cuéntanoslo en la sección de comentarios de abajo! Si le ha gustado este artículo, entonces le encantará la plataforma de Kinsta WordPress alojamiento. Acelere su lugar y reciba soporte 24/7 de nuestro equipo de Wordpress veterano. Nuestra infraestructura potenciada por Google Cloud se centra en escalamiento automático, rendimiento y seguridad. ¡Déjenos mostrarle la diferencia con Kinsta!
|
||||||||||||||||
|