¿Qué es una API?

Publicado: 2020-07-27
¿Qué es una API?
Foto por Harry Parvin

Si ha estado trabajando con tecnología durante bastante tiempo, probablemente se haya topado con el término API. Para aquellos que han estado programando y entienden cómo hacer un sitio web desde cero, estarán muy familiarizados con el término API.

Una API está detrás de muchas de las funciones populares que usa en los sitios web. Es un acrónimo que significa Interfaz de programación de aplicaciones. Un buen ejemplo sería pensar en una receta para hacer diferentes tipos de comida. Cada receta tiene instrucciones paso a paso sobre cómo crear el plato. Este es el código que está involucrado con la API. Una computadora debe seguir un conjunto de instrucciones para realizar una tarea.

Puedes tomar esa receta y dársela a cualquier chef. Podrán interpretar los ingredientes y descubrir cómo combinar todos los diferentes elementos en el producto terminado. Incluso tienes la opción de seguir las instrucciones tú mismo para armar la receta si entiendes de cocina y tienes suficiente entrenamiento para usar todas las herramientas en la cocina. Una API, al final, es solo una receta que la computadora sabe cómo seguir.

Desarrolladores y API

Continuando con nuestra ilustración de cómo funciona una API, algunos le llevarán la receta a un chef profesional que puede preparar rápidamente la comida y darle cualquier platillo que pida. Un desarrollador es como una persona que ya puede crear la receta y modificarla.

Una API es una serie de instrucciones para la computadora. Para un desarrollador con experiencia en codificación, puede ajustar algunos aspectos de la API y modificarla para satisfacer sus necesidades. Esto estará más allá del alcance de muchos que solo quieren conectar la API a su sitio.

El uso de una API es bueno para los usuarios cotidianos porque les permite obtener más funciones de su sitio web sin crear el código por su cuenta. Tal vez le gustaría mostrar el clima y la hora para un usuario que visita su sitio web. Este contenido es dinámico y no estático. No puedes simplemente dejar el clima por un día y dejarlo. El valor siempre está cambiando, por lo que debe acceder a una API para que la información se actualice.

API y WordPress

Si está utilizando WordPress y está buscando una manera de integrar una API, le recomendamos que lo haga a través de un complemento o tema de WordPress. Muchos complementos gratuitos y premium pueden ayudarlo a integrar las API con bastante facilidad. Sin embargo, la mayoría de ellos son muy limitados a menos que pague.

Si usted mismo tiene conocimientos de codificación, es simple integrar una API externa en su sitio de WordPress. Para eso te recomendamos esta guía de Rapidapi que explica cómo integrar APIs externas.

Contenido dinámico

Siempre que se trate de contenido dinámico, su primer pensamiento debe ser encontrar una API que pueda alimentar la información que cambia rápidamente a su sitio web. También puede permitirle interactuar con programas populares en un nivel más profundo.

Tomemos, por ejemplo, Twitter. Esta es una plataforma popular para las personas interesadas en las redes sociales. Si eres parte del marketing digital, querrás acceder a las cosas en un nivel más profundo. Usando la API de Twitter, puede extraer información rápidamente en hojas de cálculo para desglosarla y averiguar cosas como los intereses de los usuarios y cuántas conexiones tienen. Si es un comercializador digital, querrá identificar rápidamente a las personas en ciertos grupos demográficos para saber qué productos ofrecerles. La API de Twitter le permite hacer estas cosas porque puede extraer grandes cantidades de información de una sola vez en lugar de compilar todo a mano.

Mejorando su sitio

Hemos analizado brevemente cómo puede mejorar su negocio mediante el uso de una API para una gran empresa. ¿Qué más podemos extraer de sitios web externos? Además de cargar el clima para un usuario que cambia dinámicamente, podemos mostrar algo un poco más interesante.

¿Qué le parecería un sitio web que pueda mostrar las últimas imágenes de Flickr o incluso de Facebook? Este sería un excelente contenido para sus usuarios en el que estarán interesados. Para esto, primero, ubique la documentación de la API para Flickr. Es importante pasar por esto primero si tiene problemas para integrar la API en su sitio.

Ahora verá la posibilidad de solicitar el formato que desee. Para muchas API, tendrá opciones como REST, XML-RPC y SOAP. En este caso, elija REST, que es muy popular entre los sitios de WordPress. Cuando haga clic en esto, se le presentará un punto final de la API REST de Flickr.

¿Qué es REST?

REST es otro acrónimo que debe aprender si desea tener contenido dinámico y en constante cambio en su sitio. Con REST, podemos usar GET, POST y DELETE. Esto es para cualquier dato en Flickr, pero también funciona para Facebook, Google o Instagram.

El acrónimo significa Transferencia de Estado Representacional. Fue creado para distribuir hipermedia y apareció por primera vez con Roy Fielding en 2000. Ahora puede tener solicitudes HTTP que obtendrán datos por usted. Las solicitudes HTTP también pueden publicar datos en otros sitios web. La API es el lenguaje que hablan dos programas de computadora cuando hablan entre sí y se comunican. Al comprender este lenguaje y cómo funciona, puede extraer datos de casi cualquier sitio.

Claves API

Los sitios web no facilitarán la extracción de datos para mostrarlos en su sitio de WordPress. Primero necesitas crear una cuenta. Una vez que tenga su cuenta en el sitio web, solicite una clave API. Asegúrese de leer los términos del servicio. Hay términos específicos que serán diferentes según el sitio web con el que esté trabajando. Algunos sitios limitarán la cantidad de solicitudes HTTP GET que puede realizar durante un período de tiempo determinado.

Quizás esté restringido a solo 50 solicitudes GET para un día determinado. Esto asegura que los servidores no estén siendo atacados constantemente por personas que buscan hacer solicitudes de recursos. Puede aumentar los límites como estos muchas veces optando por una versión Pro o una versión comercial. Cuando actualice, tendrá acceso a más solicitudes HTTP que utiliza para llamar a los servidores. Por lo general, esto lo usará una empresa que necesita hacer muchas llamadas y no se aplicaría a un usuario normal que solo está tratando de mostrar nueva información en su sitio.

Solicitar permiso

No siempre podrá obtener permiso para tener una clave API. Algunos sitios requieren que presente una solicitud y explique el motivo por el que desea acceder a la clave. Las empresas no quieren una gran carga en sus recursos a menos que el desarrollador esté utilizando activamente las llamadas para ayudar a promocionar sus propios productos y servicios. Incluso pueden hacer que un equipo revise su solicitud. Si desea familiarizarse con la tecnología, solicite acceso desde un sitio de Flickr donde los requisitos sean bajos. Ahora tendrá su clave y el código junto con ella.

Autenticación y API

A continuación, considere si desea utilizar la API para obtener datos que requieran autenticación. Por ejemplo, si usara una API de Facebook o Instagram que le permite publicar imágenes y texto, deberá autenticarse. ¿Por qué es esto? Bueno, si lo piensas de esta manera, necesitarás tener una cuenta para publicar en Facebook normalmente. No se puede publicar de forma anónima en el sitio. De manera similar, si una API está publicando en su nombre, también debe autenticarse con un nombre de usuario y contraseña para ingresar. Esto lo identificará y el contenido publicado se vinculará con usted si se publican cosas que no deberían ser.

Muchos sistemas usarán OAuth para la autenticación, ya que el protocolo es fácil de usar y brinda a los usuarios una forma simple de hacer que la API interactúe con un sitio web como un proxy. La información se envía a través de un enlace seguro para que no se revele la identidad del usuario. Sin embargo, no siempre tiene que estar autenticado.

Poniendolo todo junto

Ahora tenemos todas las piezas que necesitamos para comenzar a hacer llamadas a la API. En WordPress, acceda a Apariencia y luego a Widgets. Estos están escritos en PHP. Con la documentación de la API que extrajo del sitio web, péguela para comenzar a realizar solicitudes. En el caso de utilizar la API de Flickr, la URL sería https://flickr.com/services/rest

En el código, si ve una línea para su clave API, cópiela cuando la solicitó y recibió su contraseña y clave. Cuando recupera los datos de un sitio, puede estar en formato HTML, XML, texto o JSON. Suponga que no está completamente familiarizado con todos estos formatos; eso está bien. Seleccione uno con el que podrá trabajar y poder interpretarlo más tarde.

API de Wordpress
Foto por Harry Parvin

Mirando los datos

Una vez que haya terminado de pegar la información necesaria para obtener los datos, también necesitará un archivo PHP o un archivo de WordPress para leer los datos y mostrar la información en la pantalla. Una vez más, vuelva a la documentación de la API en el sitio de la empresa con la que está trabajando. Debe haber un bloque de código que genere los datos en un formato que pueda leer como texto o mostrar como imágenes en su sitio de WordPress.

Formateo de los datos

Una vez que vea que los datos aparecen en su sitio, puede parecer extraño. El formato es solo el flujo de datos sin procesar. Cuando realiza una llamada API a un sitio externo, no se intenta formatearlo de una manera que se vea agradable. Si desea dar forma a los datos de manera que se vean presentables, puede usar un archivo CSS que está dirigido a pulir todo. Si tiene problemas para escribir el CSS, puede encontrar ejemplos en línea para orientarlo. Copie el código en su archivo CSS para que su sitio de WordPress pueda acceder a él.

Conclusión

Este fue un breve tutorial sobre cómo integrar una API con su sitio de WordPress. El tema es complejo y puede ser difícil incluso al copiar el código. Regístrese en algunos sitios en línea si tiene problemas y recuerde volver a Superb Themes para obtener más reseñas y tutoriales.