En este breve tutorial veremos cómo manipular los datos del sitio web con PHP. Foursquare ofrece algunas herramientas excelentes para acceder a la API de su sitio web.
¡Trabajaremos con una tecnología de conexión abierta OAuth para autenticar a los usuarios en nuestras propias aplicaciones Foursquare de terceros!
Registrándose
La última moda de las redes sociales en la web actual se centra en las redes sociales basadas en la ubicación. Compañías como Gowalla y, sobre todo, Foursquare ejecutan un sistema de registro de redes sociales. Por cada visita a su plaza de compras, pizzería, parque o escuela local, puede actualizar su estado y ganar puntos para desbloquear insignias.
La red gira al mundo en un juego digital de todo tipo. A través de la aplicación móvil de Foursquare, puede ejecutar su propia cuenta de usuario, actualizar los registros en Twitter o Facebook, cargar fotos y mucho más. Los números han estado creciendo rápidamente y la comunidad de Foursquare rodea el mundo.
Recursos para principiantes
Cuando empiezas a desarrollar sobre las interfaces de programación de aplicaciones, hay muchos obstáculos que superar. A través de algunos artículos fantásticos, las búsquedas de Google contienen la respuesta a muchas de sus preguntas básicas sobre conexiones PHP y API.
Cuando discuto la API de Foursquare, recomiendo altamente su foro de grupos de Google. Viene con algunas páginas de preguntas frecuentes y excelentes discusiones de usuarios archivadas a lo largo del tiempo. Más específicamente, ofrecen la documentación de la API web de una manera elegante para principiantes y profesionales por igual.
Para empezar necesitarás una configuración web sencilla de PHP. Si tienes espacio de servidor remoto, alternativamente puedes alojar todo en otro lugar. Sin embargo, si es impaciente y no necesita acceso a Internet, es mucho más sencillo instalar un entorno de servidor local.
Para Windows y Mac, los paquetes WAMP y MAMP funcionan tremendamente bien. Se instalan con las capacidades de base de datos PHP y MySQL que se ejecutan bajo el software del servidor web Apache.
Bibliotecas externas y OAuth
Solo necesitamos unos pocos archivos externos para trabajar con Foursquare de manera eficiente. Al crear una aplicación OAuth, hay muchos pasos simples necesarios para comenzar. Esta es una plataforma abierta construida con estándares simplistas en mente.
A continuación se muestra una descripción general de una conexión OAuth:
- Obtener solicitud llave y secreto de la API de Foursquare
- Añadir enlace de inicio de sesión / autenticación en algún lugar en el sitio web
- El usuario hace clic en el enlace. Dirigido a Foursquare y aprueba / rechaza el acceso a su cuenta desde aplicaciones de terceros.
- Tienda ahora asegurada llave y secreto para llamar a las solicitudes de la base de datos Foursquare
Necesitará una cuenta de Foursquare para obtener su clave y secreto en primer lugar. Es un registro gratuito, y si desea trabajar en la API, estoy seguro de que ya ha tenido interés en la aplicación. Una vez que haya iniciado sesión, revise su formulario de registro de OAuth para crear su nueva aplicación.
Deberá proporcionar tres (3) bits de datos antes de obtener su clave única y su par de cadenas secretas. El nombre de la aplicación, la URL del sitio web y la URL de retorno. Los dos primeros son bastante explicativos, mientras que URL de retorno es simplemente la página en la que Foursquare redireccionará a los usuarios hacia atrás una vez que se complete la autenticación.
Escogiendo Bibliotecas
El último paso después de la creación de la cuenta es averiguar qué bibliotecas externas usar. Cuanto más simple y fácil sea que podamos acceder a bits de datos, más rápido se ejecutará nuestra aplicación. Github es una comunidad fantástica donde los desarrolladores comparten sus bits de código con el mundo.
Específicamente, la biblioteca async Foursquare de jmathai del usuario es perfecta para lo que estamos haciendo. Puede descargar el paquete directamente desde esa página. Dentro encontrarás algunos archivos, a saber, las bibliotecas centrales con las que tendremos que trabajar. A continuación se enumeran:
- index.php
- callback.php
- EpiCurl.php
- EpiFoursquare.php
- EpiOAuth.php
Dentro de nuestro index.php archivo hay algunos campos que requieren alguna entrada. Hacia la parte superior tenemos dos (2) variables nombradas. $ consumer_key y $ consumer_secret. Dentro, querrá establecer el valor de la cadena en lo que Foursquare haya configurado en la configuración de su aplicación OAuth.
El segundo archivo que necesitamos editar es callback.php. Esto manejará una devolución de llamada genérica de Foursquare y nos permite obtener información sobre la solicitud de autorización (aceptación / rechazo). Hacia la parte superior de este archivo verá las mismas variables que solicitan el mismo conjunto de valores: aparentemente redundantes, pero útiles para mantener los scripts independientes.
Obtención de datos del usuario
Intenta cargar tu index.php archivo dentro de cualquier navegador de su servidor local. Debería ver una pequeña página con un enlace de inicio de sesión: al hacer clic en esto, se redirigirá a Foursquare, donde podrá elegir permitir o denegar la conexión a su aplicación. Una vez aceptado, será redirigido hacia su URL de devolución de llamada y podrá extraer los datos del usuario a voluntad.
Como un breve ejemplo, examinemos el historial de registro. A través de estas pocas líneas de código, podemos extraer fácilmente los últimos registros de cualquier cuenta autorizada y mostrarlos en pantalla (¡o posiblemente almacenarlos en una base de datos para un fácil acceso!)
Primero establecemos una variable única $ fsqUsrHistoria Para mantener nuestro objeto de la historia. Esto debería devolver una matriz que contiene información específica sobre cada uno de los registros anteriores de la cuenta de destino. El PHP print_r () La función mostrará la matriz de respuestas en texto sin formato en la pantalla.
Conclusión
Esta ha sido una mirada básica para comenzar con la API de Foursquare. OAuth es un protocolo abierto muy poderoso para conectarse a comunidades sociales más grandes. Ofrece las soluciones más seguras tanto para usuarios como para webmasters.
Si todavía estás un poco perdido, es de esperar al principio.Intente descargar el paquete desde Github y jugar con algunos de los archivos. Incluso las habilidades rudimentarias de PHP serán suficientes al trabajar con estas bibliotecas, por lo que es difícil desordenar las cosas.
El centro de desarrolladores de Foursquare es una herramienta increíble para los novatos. Recorra los recursos y busque y llame a las llamadas de función que le puedan interesar. Del mismo modo, el sitio web oficial de OAuth tiene algunas lecturas increíbles que describen el propósito y las soluciones prácticas para el protocolo.