Cómo usar la API REST WordPress (y las empresas que ya lo usan con éxito)

¡Hay mucho ruido en el futuro reposo API para WordPress y con razón! Después de introducir los tipos de publicaciones personalizadas de la versión 2.9, este puede ser el paso más grande para hacer de WordPress un marco de aplicación real. En resumen, la API REST permite a los desarrolladores desacoplar por completo el front-end del paquete básico de WordPress. Esto conducirá a mejores aplicaciones móviles, temas extremadamente personalizados e implementaciones con esperanza de inteligencia que ni siquiera hemos pensado. En este artículo, le mostraré cómo comenzar con el resto y algunas compañías que ya lo usan con éxito.
Una nota rápida: este elemento se dirige a los desarrolladores con una sólida comprensión de PHP y WordPress. Nociones introductorias con la API WP en este momento, necesitará la API REST de complementos para iniciar incluso la última versión de WordPress. También necesitará conocimiento sobre la API HTTP de WordPress para hacer llamadas. Para nuestro primer proyecto para este tutorial, para crear una instalación local de WordPress, que extraerá publicaciones de nuestro sitio en vivo utilizando la API REST. Asegúrese de tener una API REST de complementos instalada en el sitio en vivo y cree un complemento vacío para el widget en su sitio local. Aquí está el código estándar que solía comenzar:
Cargue la idea 24617192DCACF59038A2
Este código está contenido en una carpeta fremi-api-widget el director del complemento, en un archivo llamado REST-API-Widget.php. Contiene el encabezado del complemento, que se utiliza cuando el complemento se enumera en el administrador y un poco más del mínimo requerido para crear un widget. Si no está familiarizado con la creación de widgets, no tenga miedo, tenemos un artículo sobre la construcción de widgets de WordPress como profesional. En este artículo, nos centraremos principalmente en la función widget (), que rige la salida del widget. También usaremos la API HTTP de WordPress para realizar solicitudes y leer respuestas de la API de WordPress. Si es nuevo en el HTTP, eche un vistazo a nuestra guía práctica sobre el uso de la API HTTP. Propectando algunas publicaciones como en cualquier API REST, necesitaremos algunas cosas para hacer cada solicitud. Necesitamos saber lo siguiente:
El camino básico de la API
La ruta utilizada
El punto final utilizado
Se requieren cabezas
Parámetros
La ruta básica de API es siempre/wp-json/wp/v2/. Todas las rutas que describiré estarán relacionadas con este camino. Entonces, la URL básica completa sería http://mywebsite.com/wp-json/wp/v2/. La ruta para obtener publicaciones es/publicaciones para que la URL de la ruta completa sea http://mywebsite.com/wp-json/wp/v2/posts/. Cada ruta puede tener una serie de puntos finales que están diferenciados por el método HTTP. El camino a un solo artículo podría ser algo así como /publicaciones /325. Esta ruta tiene tres puntos finales:
Get se hará cargo de la publicación
Put actualizará la publicación
Eliminar eliminará la publicación
Para nuestro ejemplo, usaremos la ruta http://mywebsite.com/wp-json/wp/v2/posts/ con el punto final puede hacerse cargo. Usando la API HTTP, esta es una línea de código simple. Cargue la idea 24617192DCACF59038A2
En nuestro caso, la respuesta es favorable si no es un objeto wp_error y si devuelve algunas publicaciones. Los datos se devuelven al cuerpo de la respuesta que podemos tomar usando la función wp_remote_rretve_body (). El cuerpo contendrá una cadena codificada JSON con datos publicados. Aquí está el código completo para su pantalla en nuestro widget.
Cargue la idea 24617192DCACF59038A2
Esto parece un ejemplo simplista, y lo es, pero el potencial que posee es sorprendente. Si reemplaza las funciones de la API HTTP con Curl o algo más, nuestro ejemplo es prácticamente independiente de WordPress. Podríamos trabajar en Laravel, Joomla o en una aplicación móvil. El hecho de que mostremos publicaciones de WordPress en otro sistema de WordPress es pura coincidencia. Esto significa que puede crear una aplicación móvil para su tienda WooCommerce, que es completamente nativa de iPhone/Android, pero interactúa perfectamente con su sitio de WordPress, incluida la toma de pedidos, la entrega de entregas y la recepción de pagos. Convierta a WordPress en una plataforma de aplicaciones que debería mejorar todos nuestros sitios.
Haga más con el resto del resto, este ejemplo básico muestra el 90% de cómo trabaja con la API WP. Hay tres cosas más que merecemos analizar brevemente:
Memoria en caché de respuestas
Acceso
Descubrimiento más por hacer
La memorización de caché de las respuestas no es apropiada para perturbar continuamente a los servidores con llamadas cuando no es necesario. En nuestro ejemplo anterior, hemos mostrado una lista de publicaciones que probablemente no cambiarán en unos pocos segundos. El recuerdo en caché de esta respuesta durante una hora, tal vez incluso un día, sería una buena idea. Hay una serie de enfoques para resolver esto, incluido JP REST API Cache, que es una biblioteca de composición, memoria de caché y uso transitorio nativo. Le mostraré aquí un ejemplo de una transición rápida. La idea de un transitorio es que almacena datos con una fecha de vencimiento. Por defecto, ingresará la base de datos, pero algunas configuraciones permiten el almacenamiento en la memoria, lo que lo hace aún más rápido. Cuando recuperamos las publicaciones, queremos ponerlas en un período transitorio y establecer el vencimiento a una hora. Hasta el término de vencimiento, las publicaciones se toman de nuestra propia base de datos. Después de la expiración, se extraen nuevamente del sitio externo y se introducen en la transición. Así es como cambiaría la función de widget (creando una función adicional en este proceso).
Cargue la idea 24617192DCACF59038A2
Autenticación El método anterior debería funcionar sin autenticación, pero siempre debe autenticarse. Eche un vistazo a la sección de autenticación de documentación para obtener más información. Cuando trabaja con tales solicitudes externas, tiene dos opciones: autenticación básica y OAuth.

La autenticación básica es la más simple, pero nunca debe usarse en la producción, porque es bastante insegura, requiere que envíe el usuario y la contraseña actuales a cada solicitud. Sin embargo, es un buen método de prueba, por lo que le mostraré cómo ponerlo en funcionamiento. Autenticación básica Para activar la autenticación básica, debe instalar un complemento en el sitio de destino. Una vez que se haya activado, podrá hacer llamadas autenticadas. Para comenzar, debe establecer un encabezado de autorización con el valor básico . Suponiendo que su nombre de usuario sea mrawesome y su contraseña es increíble, puede crear este encabezado y autenticar una llamada de la siguiente manera: Cargue la idea 24617192DCACF59038A2
Tenga cuidado, si utiliza su propia URL de sitio web y está correctamente autenticado, ¡eliminará la publicación con la identificación 1183! Como puede ver, el manejo de datos es extremadamente simple con API, es realmente un placer funcionar. Autenticación de Outh Este método de autenticación también requiere un complemento para instalar. Una vez que la API se combina en el núcleo, se incluirá este complemento, por lo que no tendrá que preocuparse por varios complementos separados. Desafortunadamente, en este momento, la documentación para OAuth es un desastre, por lo que no podré mostrarle cómo hacer esto ahora mismo.
Esto implica la instalación del uso de la interfaz WP-CLI de una interfaz de línea de comandos de WordPress, la instalación de una extensión de la comunidad para el cliente WP CLI y el uso de los dos juntos. Esto realmente no pondría un problema, pero un pedido enumerado no está disponible y dificulta nuestras vidas de lo que debería ser. Una vez que hay instrucciones fáciles de usar disponibles, informaré sobre cómo hacerlo. Por ahora, podemos permanecer en la prueba del agua con la autenticación básica. Cuanto más descubra el descubrimiento para recomendar calurosamente leer la página de descubrimiento de la documentación y navegar en general. Encontrará todos los métodos que le permiten interactuar con usuarios, tipos de publicaciones, medios, metadatos y todo lo que pueda necesitar. Parte del aprendizaje de cualquier API está familiarizado con todas las opciones, y WordPress API no es una excepción. Encontrará algunos extraños, como el hecho de que no puede eliminar a los usuarios y otros problemas menores, pero tenga en cuenta que esto todavía está en progreso y se describe bellamente. Empresas que usan la API REST en este momento, incluso si la API REST aparece desde el principio, muchas compañías ya la están utilizando. Aquí hay una lista de unos pocos que prueban las aguas: Event Espresso, un complemento de gestión de eventos popular, lo utiliza para proporcionar acceso a sus datos
Human Made lo usa para crear sitios de clientes cuando el cliente quiere algo más flexible en el frente.
Un complemento premium llamado Editus lo usa para alimentar sus capacidades de edición front-end
WP Búsqueda en vivo-un complemento gratuito lo usa para alimentar su funcionalidad de búsqueda
Join en Usarlo para alimentar a un widget JS Inorpossilmodern Tribe lo usa para alimentar tanto el manillar
Simmer-un instrumento para publicar las recetas, usa para construir sus propios desarrolladores y ayudar a otros a convertir los libros de cocina en aplicaciones móviles que pueden vender fácilmente.
¿Según quién usa esto?Publique en hacer wordpress.Muchas personas usan API para crear aplicaciones móviles para sus sitios web.
¿Dónde encajas?¿Usa el descanso API WP?Nos gustaría averiguar cómo lo usa o tiene la intención de usarlo.¿Qué opinas sobre las oportunidades que ofrecen?¿Considera que es la forma de seguir para la comunidad de WordPress o es solo un Moft transitorio?Cuéntanos tu opinión sobre la API REST en los comentarios a continuación.Etiquetas:
API REST WP