\u00bfQu\u00e9 es API de REST de WordPress?<\/h2>\n
API REST de WordPress es una interfaz que los desarrolladores<\/a> pueden utilizar para acceder a WordPress desde fuera de la propia instalaci\u00f3n de WordPress. Se accede a \u00e9l utilizando JavaScript, lo que significa que se puede utilizar para crear sitios web y aplicaciones interactivas.<\/p>\n REST significa Representational State Transfer y API significa Application Programming Interface. Echemos un vistazo a lo que significa cada uno de ellos.<\/p>\n Una Interfaz de Programaci\u00f3n de Aplicaciones, o API, se define<\/a> como:<\/p>\n \u00abUna interfaz o protocolo de comunicaci\u00f3n entre un cliente y un servidor para simplificar la construcci\u00f3n de software del lado del cliente.\u00bb<\/p><\/blockquote>\n Si no est\u00e1 familiarizado con las API, es posible que eso no le ayude mucho. En pocas palabras, una API es un conjunto de c\u00f3digo que permite a un sistema interactuar (o \u00abinterfaz\u00bb) con otro. Si alguna vez ha a\u00f1adido un mapa de Google a su sitio de WordPress<\/a>, ha utilizado API de Google Maps, que permite que su sitio de WordPress interact\u00fae con Google Maps.<\/p>\n Estos sistemas no necesitan estar completamente separados. WordPress ya tiene m\u00faltiples APIs<\/a>, para cosas como plugins<\/a>, configuraciones y atajos<\/a>. Estos pueden ser utilizados por los desarrolladores de plugins y temas para interactuar con el n\u00facleo de WordPress y hacer que las cosas sucedan (como crear atajos y a\u00f1adir pantallas de configuraci\u00f3n al administrador de WordPress).<\/p>\n La diferencia con la API de REST es que permite que los sistemas fuera de la propia instalaci\u00f3n de WordPress interact\u00faen con WordPress, que es donde entra en juego la parte de REST.<\/p>\n Representational State Transfer, o REST, proporciona est\u00e1ndares que los sistemas web pueden utilizar para interactuar entre s\u00ed. Sin REST, dos sistemas no podr\u00edan entenderse entre s\u00ed y, por lo tanto, enviar datos de un lado a otro.<\/p>\n Para que una aplicaci\u00f3n sea RESTful<\/a>, debe cumplir con cinco principios:<\/p>\n Todas estas restricciones se refieren a p\u00e1ginas web y aplicaciones y rigen la forma en que una aplicaci\u00f3n puede interactuar con la API.<\/p>\n La combinaci\u00f3n de REST y API significa que\u00a0 API REST de WordPress es un conjunto de c\u00f3digo dise\u00f1ado para hacer posible que otros sistemas interact\u00faen con WordPress y que est\u00e1 construido de una manera que asegura que estos sistemas se entiendan entre s\u00ed.<\/p>\n Esto significa que un sitio web de terceros o una aplicaci\u00f3n m\u00f3vil, por ejemplo, puede acceder a la base de datos de WordPress<\/a>, obtener datos de ella y a\u00f1adir datos a la misma.<\/p>\n Sin embargo, hay una serie de implicaciones y usos para esto.<\/p>\n API REST de WordPress fue desarrollada en respuesta a los cambios en la forma en que se desarrollan los sitios web y las aplicaciones y a la necesidad de abrir WordPress m\u00e1s ampliamente.<\/p>\n API REST de WordPress fue lanzada<\/a> como parte del n\u00facleo en la versi\u00f3n 4.7 en diciembre de 2016, pero ya estaba disponible como un plugin antes de esa fecha.<\/p>\n Est\u00e1 dise\u00f1ado para soportar una amplia gama de aplicaciones construidas sobre WordPress y para transformar WordPress de un sistema de gesti\u00f3n de contenidos<\/a> a una plataforma de aplicaciones.<\/p>\n Es utilizado ampliamente por WordPress.com<\/a>, cuya interfaz basada en JavaScript utiliza API REST para interactuar con la base de datos de WordPress. Tambi\u00e9n es utilizado por la interfaz de edici\u00f3n de Gutenberg<\/a>, que se convirti\u00f3 en parte del n\u00facleo en 2019.<\/p>\n API REST ampl\u00eda la gama de aplicaciones para las que se puede utilizar WordPress. Mientras que un sistema de gesti\u00f3n de contenidos destaca en la ejecuci\u00f3n de un sitio web complejo, una plataforma de aplicaciones tambi\u00e9n se puede utilizar para impulsar aplicaciones de una sola p\u00e1gina basadas en web o SPAs (si alguna vez ha utilizado Google Docs<\/a>, ha utilizado uno de ellos).<\/p>\n En estos, el contenido se actualiza cuando el usuario toma acci\u00f3n, en lugar de cargar nuevas p\u00e1ginas. Debido a que utiliza JavaScript (un lenguaje del lado del cliente) en lugar de PHP<\/a> (un lenguaje del lado del servidor), puede hacer que las cosas sucedan en el navegador del usuario sin tener que enviar constantemente peticiones al servidor.<\/p>\n Si usted es un usuario y\/o desarrollador que trabaja con WordPress, API REST tiene una serie de implicaciones.<\/p>\n Para los usuarios, estos incluyen:<\/p>\n Para los desarrolladores, hay implicaciones y posibilidades m\u00e1s amplias:<\/p>\n Con el tiempo, API REST de WordPress significar\u00e1 que la mayor parte del n\u00facleo de WordPress se escribir\u00e1 en JavaScript y no en PHP. Si es un desarrollador de WordPress, esto significa que necesitar\u00e1 aprender JavaScript.<\/p>\n \u00bfC\u00f3mo se accede a API REST de WordPress?<\/p>\n Para acceder a WP-API REST, deber\u00e1 acceder a su sitio a trav\u00e9s de la l\u00ednea de comandos. Con WordPress, esto se llama WP-CLI<\/a>. Usted no hace nada de esto a trav\u00e9s de sus pantallas de administraci\u00f3n o accediendo directamente al c\u00f3digo de su sitio.<\/p>\n Echemos un vistazo a c\u00f3mo empezar.<\/p>\n WP-CLI es la interfaz de l\u00ednea de comandos de WordPress. Le permite acceder y trabajar con WordPress a trav\u00e9s de la interfaz de l\u00ednea de comandos (CLI) de su ordenador. WP-CLI est\u00e1 preinstalado con todos los planes de hosting de Kinsta.<\/p>\n Para acceder a la CLI, abra Terminal en un Mac o en Linux, o S\u00edmbolo del sistema en Windows.<\/p>\n Terminal on Mac<\/p>\n Para acceder a un sitio remoto, necesita SSH en su servidor<\/a> para acceder a \u00e9l a trav\u00e9s de WP-CLI (\u00bfNo puede conectarse por SSH? Aprenda a arreglar el error de \u00abConnection Refused\u00bb de SSH<\/a>).<\/p>\n Para acceder a un sitio local<\/a>, basta con utilizar la estructura de directorios correcta desde la l\u00ednea de comandos. Es una buena idea experimentar con API REST en un sitio de pruebas local antes de probarla en un sitio en vivo.<\/p>\n Necesitar\u00e1 acceder espec\u00edficamente a API REST de su sitio, de esta manera:<\/p>\n A continuaci\u00f3n, puede a\u00f1adir elementos para acceder a determinados tipos de datos, que analizaremos con m\u00e1s detalle en breve. Estos elementos se denominan puntos finales.<\/p>\n Una vez que haya accedido a su sitio, es posible que tenga que pasar por un proceso de autenticaci\u00f3n. Algunos endpoints son p\u00fablicos y no requieren autenticaci\u00f3n, mientras que otros s\u00ed.<\/p>\n No est\u00e1 iniciando sesi\u00f3n en el administrador de su sitio<\/a> aqu\u00ed: API REST hace las cosas de forma un poco diferente.<\/p>\n Para poder autenticar su sitio a trav\u00e9s de WP-CLI, necesitar\u00e1 instalar un plugin de autenticaci\u00f3n. Para las instalaciones de desarrollo, el plugin Basic Auth<\/a> hace el trabajo y es f\u00e1cil de usar.<\/p>\n Sin embargo, para sitios en vivo, deber\u00eda utilizar una forma m\u00e1s robusta de autenticaci\u00f3n como el plugin JWT Authentication<\/a>, que utiliza JSON Web Token y es m\u00e1s seguro.<\/p>\n A continuaci\u00f3n, puede utilizar la l\u00ednea de comandos para acceder a los datos e incluir la autenticaci\u00f3n.<\/p>\n El siguiente ejemplo utiliza Los borradores de mensajes no son informaci\u00f3n p\u00fablica, por lo que necesita autenticaci\u00f3n para acceder a ellos. Pero si est\u00e1 buscando datos que son p\u00fablicos, no necesita autenticaci\u00f3n. As\u00ed que para recuperar una lista de mensajes que han sido publicados, puede utilizar:<\/p>\n Esto obtendr\u00eda todos los mensajes publicados porque son p\u00fablicos.<\/p>\n Una vez que haya accedido a su sitio y sepa c\u00f3mo utilizar la autenticaci\u00f3n (y, de hecho, si es necesario), tendr\u00e1 que utilizar uno de una serie de comandos para interactuar con su sitio.<\/p>\n Los comandos que necesitar\u00e1 usar son:<\/p>\n Echemos un vistazo a cada uno de ellos por separado.<\/p>\n El commando Tenga en cuenta que no he incluido la ruta completa a su sitio en la l\u00ednea de arriba, ya que ya ha accedido a ella utilizando WP-CLI.<\/p>\n Una vez recuperados esos datos, puede utilizarlos para informar al siguiente paso. Puede borrar uno de esos mensajes, editarlo o actualizarlo. Podr\u00eda simplemente enviar mensajes a su aplicaci\u00f3n web.<\/p>\n Digamos que quiere ir a buscar el \u00faltimo post. Usar\u00eda esto:<\/p>\n Hay una serie de argumentos que puede usar cuando trabaja con mensajes. Consulte el Manual de\u00a0 API REST de WordPress<\/a> para obtener m\u00e1s informaci\u00f3n.<\/p>\n Utilice As\u00ed que, por ejemplo, si quiere crear un mensaje, empezar\u00e1 usando un comando Esto crear\u00eda un nuevo borrador vac\u00edo.<\/p>\n A continuaci\u00f3n, puede actualizar el mensaje utilizando un comando Con un comando Para a\u00f1adir una p\u00e1gina a su sitio, puede utilizar algo como esto:<\/p>\n Esto crear\u00eda una p\u00e1gina vac\u00eda de la misma manera que crear\u00eda una entrada vac\u00eda.<\/p>\n El comando Supongamos que tiene varios borradores en su sitio web. Quiere comprobarlas y actualizar una para que se publique.<\/p>\n Podr\u00edas empezar por obtener una lista de todos los mensajes de borrador:<\/p>\n El sistema le dar\u00e1 una lista de todos los borradores actuales. Puede modificar el status de uno de ellos utilizando su ID:<\/p>\n Esto accede a ese mensaje y le permite editarlo. A continuaci\u00f3n, puede modificar su status utilizando el argumento de status:<\/p>\n O bien, puede agregar contenido al mensaje y publicarlo:<\/p>\n El servidor devolver\u00e1 un estado de El comando As\u00ed que si quisiera mover el mensaje que acaba de crear a la papelera, usar\u00edas esto:<\/p>\n Sin embargo, si quisiera pasar por alto la papelera y eliminarla permanentemente, usar\u00eda el argumento Esto elimina permanentemente el mensaje sin opci\u00f3n de deshacerlo, por lo que se debe usar con precauci\u00f3n.<\/p>\n API REST de WordPress no siempre ser\u00e1 el enfoque correcto para desarrollar un sitio web o una aplicaci\u00f3n. He aqu\u00ed algunas consideraciones que debe tener en cuenta antes de utilizarlo para el desarrollo:<\/p>\n Si su aplicaci\u00f3n se va a utilizar en dispositivos que no ejecutan JavaScript o por usuarios que probablemente la tengan desactivada, no se ejecutar\u00e1 si est\u00e1 utilizando API REST.<\/p>\n Un sitio WordPress codificado en PHP producir\u00e1 HTML para que no sufra este problema. Los dispositivos que no usan JavaScript son cada vez m\u00e1s raros, pero si est\u00e1 desarrollando espec\u00edficamente para ellos, API REST no funcionar\u00e1.<\/p>\n Del mismo modo, si es probable que sus usuarios desactiven JavaScript, entonces trabajar con API REST causar\u00e1 problemas. Algunos usuarios desactivan JavaScript en sus navegadores por razones de accesibilidad o seguridad.<\/p>\n Los sitios o aplicaciones desarrollados con JavaScript no siempre son tan accesibles como los que salen en HTML.<\/p>\n Esto se debe en gran medida a la forma en que se utiliza JavaScript para entregar contenido din\u00e1mico que puede no funcionar bien con los lectores de pantalla y puede causar problemas a las personas con deficiencias visuales o epilepsia fotosensible.<\/p>\n Usar API REST para acceder a su sitio WordPress y a los datos de salida de una forma que est\u00e9 dise\u00f1ada para ser accesible significa que puede superar estos problemas, pero vale la pena comprobar la accesibilidad de su sitio mientras lo est\u00e1 desarrollando.<\/p>\n Las aplicaciones de una sola p\u00e1gina, que se actualizan con frecuencia, a veces pueden causar problemas de SEO<\/a>. Esto se debe a que el contenido que no se entrega cuando se imprime por primera vez la p\u00e1gina puede no ser indexado por los motores de b\u00fasqueda.<\/p>\n Google y otros motores de b\u00fasqueda se<\/a> est\u00e1n poniendo al d\u00eda con el hecho de que muchos sitios web ahora tienen SPA y los est\u00e1n indexando adecuadamente. Pero vale la pena hacer una auditor\u00eda SEO<\/a> completa de cualquier sitio que desarrolle utilizando API REST.<\/p>\n Si no desea que las aplicaciones puedan acceder a los datos de su sitio mediante API REST, puede desactivarla. Recuerde que los datos p\u00fablicos pueden ser accesibles para cualquier persona, no s\u00f3lo para usted.<\/p>\n Para ello, puede instalar el plugin Desactivar WP REST API<\/a>. Esto desactiva la API REST para cualquiera que no haya iniciado sesi\u00f3n en su sitio.<\/p>\n Alternativamente, puede agregar alg\u00fan c\u00f3digo al archivo de funciones de su tema o escribir su propio plugin. Es mejor escribir un plugin ya que no es una funcionalidad espec\u00edfica del tema.<\/p>\n En su plugin, agregue s\u00f3lo dos l\u00edneas:<\/p>\n Esto deshabilitar\u00e1 completamente API REST para su sitio. Puede que tenga efectos secundarios para sus pantallas de administraci\u00f3n, as\u00ed que aseg\u00farese de que todo funciona correctamente una vez que lo haya a\u00f1adido.<\/p>\n La API REST presenta algunas posibilidades interesantes para el futuro de WordPress. Aqu\u00ed hay algunos ejemplos de aplicaciones y sitios que utilizan API REST de WordPress para crear SPAs o para enlazar WordPress con otros sitios y tecnolog\u00edas.<\/p>\n Las pantallas de administraci\u00f3n de WordPress.com est\u00e1n construidas completamente usando API REST para proporcionar un SPA con el que los usuarios interact\u00faan para administrar su sitio.<\/p>\n Esto hace que la comunicaci\u00f3n entre la interfaz y el servidor sea din\u00e1mica y resulta en una interfaz f\u00e1cil de usar que WordPress.org probablemente imitar\u00e1 con el tiempo.<\/p>\n Tambi\u00e9n en las pantallas de administraci\u00f3n de WordPress, pero esta vez tambi\u00e9n en WordPress autohospedado, el editor de bloques de Gutenberg utiliza API REST para comunicarse con su base de datos y crear bloques.<\/p>\n Para que los tipos de mensajes funcionen con el editor Gutenberg, deben tener habilitada API REST. Lo que significa que si est\u00e1 registrando un tipo de mensaje personalizado<\/a> y utiliza Gutenberg, tendr\u00e1 que a\u00f1adir la siguiente l\u00ednea para habilitar el editor de bloques para ese tipo de mensaje:<\/p>\n Event Espresso<\/a> es un plugin de WordPress que permite a los usuarios organizar y publicitar eventos. Utiliza API REST para que los usuarios puedan acceder a los datos desde fuera de WordPress. Esto significa que puede crear aplicaciones m\u00f3viles o SPAs para gestionar sus eventos.<\/p>\n UsTwo<\/a> es una agencia digital cuyo sitio fue construido usando API REST como una aplicaci\u00f3n de una sola p\u00e1gina. Esto combina un front-end construido usando React con un backend alimentado por WordPress (lectura sugerida: Su gu\u00eda para iniciar y dirigir una exitosa agencia de WordPress<\/a>).<\/p>\n El contenido de su p\u00e1gina \u00fanica es modular, con una estructura diferente a la de una p\u00e1gina est\u00e1ndar de WordPress. Para que esto funcione, utilizan un plugin de creaci\u00f3n de p\u00e1ginas personalizado que permite a su equipo a\u00f1adir contenido modular al sitio.<\/p>\n El sitio web de USA Today<\/a> fue reconstruido usando la integraci\u00f3n de API REST WordPress con los sistemas y m\u00f3dulos existentes en el sitio.<\/p>\n API REST permiti\u00f3 que el contenido del sitio fuera enviado a otros puntos de venta como Facebook Instant Articles<\/a> y Apple News, utilizando JSON. Tambi\u00e9n escribieron un juego social en l\u00ednea para su secci\u00f3n de deportes, construido usando JavaScript.<\/p>\n\n\u00bfQu\u00e9 es una Interfaz de Programaci\u00f3n de Aplicaciones (API)?<\/h3>\n
\u00bfQu\u00e9 es la transferencia estatal de representaci\u00f3n (REST)?<\/h3>\n
\n
\u00bfQu\u00e9 significa esto para WordPress?<\/h3>\n
Entendiendo API REST de WordPress<\/h2>\n
Fondo de API REST de WordPress<\/h3>\n
Implicaciones para los usuarios y desarrolladores de WordPress<\/h3>\n
\n
\n
\u00bfC\u00f3mo acceder a API REST de WordPress?<\/h2>\n
Acceso a WP-REST mediante WP-CLI<\/h3>\n
![\"Terminal](\"https:\/\/kinqsta.com\/es\/wp-content\/uploads\/sites\/8\/2019\/10\/Terminal-en-Mac-1.jpg\")
<\/p>\nhttp:\/\/yoursite.com\/wp-json\/wp\/v2<\/code><\/pre>\nAutenticaci\u00f3n<\/h3>\n
curl<\/code> para probar la conexi\u00f3n con WordPress. Se emitir\u00e1 una lista de borradores de puestos.<\/p>\ncurl -X GET --user username:password -i http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts?status=draft<\/code><\/pre>\ncurl -X GET http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts<\/code><\/pre>\nDescripci\u00f3n general de los comandos de API REST de WordPress<\/h2>\n
\n
GET<\/code> recupera un recurso como un post u otros datos.<\/li>\nPOST<\/code> a\u00f1ade un recurso al servidor, como un mensaje, un archivo adjunto u otro recurso.<\/li>\nPUT <\/code>se puede utilizar para editar o actualizar un recurso que ya est\u00e1 en el servidor.<\/li>\nDELETE<\/code> elimina un recurso del servidor. Util\u00edcelo con cuidado!<\/li>\n<\/ul>\nGET<\/h3>\n
GET<\/code>\u00a0 es probablemente el m\u00e1s utilizado: recupera datos. El siguiente ejemplo (que se utiliza una vez que cuando se accede con \u00e9xito a tu sitio web) le mostrar\u00e1 una lista de todas las p\u00e1ginas publicadas en su sitio:<\/p>\nGET http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/?status=published<\/code><\/pre>\nGET http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/?per_page=1<\/code><\/pre>\nPOST<\/h3>\n
POST<\/code> para a\u00f1adir nuevos datos o recursos a su sitio.<\/p>\nPOST<\/code>:<\/p>\nPOST http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/<\/code><\/pre>\nPUT<\/code> para editarlo.<\/p>\nPOST<\/code>, tambi\u00e9n puede agregar otros recursos adem\u00e1s de los puestos, incluyendo adjuntos y otros tipos de puestos.<\/p>\nPOST http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/pages<\/code><\/pre>\nPUT<\/h3>\n
PUT<\/code> le permite editar un recurso existente, incluyendo los mensajes.<\/p>\nPOST http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/?status=\"draft\"<\/code><\/pre>\nPUT http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/567<\/code><\/pre>\n{\n\"status\" = \"publish\"\n}<\/code><\/pre>\n{\n\"status\" = \"publish\"\n\"content\" = \"content here\"\n}<\/code><\/pre>\n200 - OK<\/code> que indica que la petici\u00f3n PUT ha editado correctamente el mensaje.<\/p>\nDELETE<\/h3>\n
DELETE<\/code> hace lo que usted esperar\u00eda: borra un recurso. Por defecto, si lo usa para borrar un mensaje, lo pondr\u00e1 en la papelera en lugar de borrarlo permanentemente.<\/p>\nDELETE http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/567<\/code><\/pre>\nforce<\/code>:<\/p>\nDELETE http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/567?force=true<\/code><\/pre>\n\u00bfCu\u00e1ndo no usar API REST de WordPress?<\/h2>\n
Compatibilidad<\/h3>\n
Accesibilidad<\/h3>\n
SEO<\/h3>\n
\u00bfC\u00f3mo desactivar la API de REST de WordPress?<\/h3>\n
![\"Disable](\"https:\/\/kinqsta.com\/es\/wp-content\/uploads\/sites\/8\/2019\/12\/disable-wp-rest-api.jpg\")
add_filter( 'json_enabled', '__return_false' );\nadd_filter( 'json_jsonp_enabled', '__return_false' );\n<\/code><\/pre>\nAplicaciones del mundo real utilizando API REST de WordPress<\/h2>\n
WordPress.com<\/h3>\n
![\"WordPress.com\"](\"https:\/\/kinqsta.com\/es\/wp-content\/uploads\/sites\/8\/2019\/10\/wordpressdotcom.jpg\")
El Editor de Bloques (Gutenberg)<\/h3>\n
![\"El](\"https:\/\/kinqsta.com\/es\/wp-content\/uploads\/sites\/8\/2019\/10\/editor-de-gutenberg.jpg\")
\"show_in_rest\" = true;<\/code><\/pre>\nEvent Espresso<\/h3>\n
![\"Event](\"https:\/\/kinqsta.com\/es\/wp-content\/uploads\/sites\/8\/2019\/10\/event-espresso.jpg\")
UsTwo<\/h3>\n
![\"UsTwo\"](\"https:\/\/kinqsta.com\/es\/wp-content\/uploads\/sites\/8\/2019\/10\/ustwo.jpg\")
USA Today<\/h3>\n
![\"USA](\"https:\/\/kinqsta.com\/es\/wp-content\/uploads\/sites\/8\/2019\/10\/USA-today.jpg\")
Resumen<\/h2>\n