Dans ce bref tutoriel, nous étudierons la manipulation des données de site Web avec PHP. Foursquare offre d'excellents outils pour accéder à l'API de leur site Web.
Nous allons travailler avec une technologie de connexion ouverte OAuth pour authentifier les utilisateurs dans nos propres applications Foursquare tierces!
Enregistrement
Le dernier engouement pour les médias sociaux sur le Web se concentre aujourd'hui sur les réseaux sociaux géolocalisés. Des sociétés telles que Gowalla et plus particulièrement Foursquare utilisent un système d’enregistrement sur réseau social. Pour chaque visite à un centre commercial, une pizzeria, un parc ou une école, tu peux mettre à jour ton statut et gagner des points pour le déverrouillage des badges.
Le réseau pivote dans le monde pour créer un jeu numérique. Grâce à l'application mobile de Foursquare, vous pouvez créer votre propre compte utilisateur, mettre à jour les enregistrements sur Twitter ou Facebook, télécharger des photos et bien plus encore! Les chiffres augmentent rapidement et la communauté de Foursquare tourne autour du monde.
Ressources pour débutants
Lorsque vous commencez à développer des interfaces de programmation d'applications, vous devez surmonter de nombreux obstacles. Grâce à des articles fantastiques, les recherches Google apportent la réponse à beaucoup de vos questions de base sur les connexions PHP et API.
Lors de la discussion sur l'API de Foursquare, je recommande fortement le forum de leurs groupes Google. Il contient quelques pages de FAQ et d'excellentes discussions entre utilisateurs archivées au fil du temps. Plus spécifiquement, ils offrent la documentation de l'API Web de manière élégante pour les novices et les professionnels.
Pour commencer, vous aurez besoin d’une configuration Web PHP simple. Si vous avez un espace serveur distant, vous pouvez également tout héberger ailleurs. Toutefois, si vous êtes impatient et n'avez pas besoin d'un accès Internet, il est beaucoup plus simple d'installer un environnement de serveur local.
Pour Windows et Mac, les packages WAMP et MAMP fonctionnent extrêmement bien. Ils installent avec les capacités de base de données PHP et MySQL exécutées sous le logiciel de serveur Web Apache.
Bibliothèques externes et OAuth
Nous n’avons besoin que de quelques fichiers externes pour travailler efficacement avec Foursquare. Lors de la création d'une application OAuth, de nombreuses étapes simples sont nécessaires pour commencer. Il s’agit d’une plate-forme ouverte construite dans l’esprit de normes simplistes.
Vous trouverez ci-dessous un aperçu général d'une connexion OAuth:
- Obtenir une demande clé et secret depuis l'API Foursquare
- Ajouter un lien de connexion / authentification quelque part sur le site Web
- L'utilisateur clique sur le lien. Dirigé vers Foursquare et approuve / refuse l'accès à leur compte à partir d'une application tierce
- Magasin maintenant sécurisé clé et secret appeler des demandes depuis la base de données Foursquare
Vous aurez besoin d'un compte Foursquare pour obtenir votre clé et votre secret en premier lieu. C'est une inscription gratuite, et si vous souhaitez utiliser l'API, vous êtes sûrement déjà intéressé par l'application! Une fois connecté, consultez leur formulaire d’inscription à OAuth pour créer votre nouvelle application.
Vous devrez donner trois (3) bits de données avant d’obtenir votre clé unique et votre paire de chaînes secrètes. Le nom de l'application, l'URL du site Web et l'URL de retour. Les deux premiers sont assez explicites alors que le URL de retour C’est tout simplement la page vers laquelle Foursquare redirige les utilisateurs une fois l’authentification terminée.
Choisir des bibliothèques
La dernière étape après la création du compte consiste à déterminer les bibliothèques externes à utiliser. Plus simple et facile nous pouvons accéder à des bits de données, plus notre application s'exécutera rapidement. Github est une communauté fantastique où les développeurs partagent leurs bouts de code avec le monde entier.
La bibliothèque async Foursquare de l'utilisateur jmathai est idéale pour ce que nous faisons. Vous pouvez télécharger le package directement à partir de cette page. À l'intérieur, vous trouverez quelques fichiers, notamment les bibliothèques de base avec lesquelles nous devrons travailler. Énumérés ci-dessous:
- index.php
- callback.php
- EpiCurl.php
- EpiFoursquare.php
- EpiOAuth.php
À l'intérieur de notre index.php fichier il y a quelques champs nécessitant une entrée. Vers le haut, nous avons deux (2) variables nommées $ consommateur_key et $ consommateur_secret. À l'intérieur, vous souhaiterez définir la valeur de la chaîne sur celle que Foursquare a définie dans les paramètres de votre application OAuth.
Le deuxième fichier que nous devons éditer est callback.php. Cela gérera un rappel générique de Foursquare et nous permettra d’extraire des informations sur la demande d’autorisation (acceptation / rejet). Vers le haut de ce fichier, vous verrez les mêmes variables demandant le même ensemble de valeurs - apparemment redondantes, mais utiles pour garder les scripts indépendants.
Tirer des données utilisateur
Essayez de charger votre index.php déposer dans n'importe quel navigateur à partir de votre serveur local. Vous devriez voir une petite page avec un lien de connexion - en cliquant dessus, vous serez redirigé vers Foursquare où vous pouvez choisir d'autoriser ou de refuser la connexion à votre application. Dès l'acceptation, vous serez redirigé vers votre URL de rappel et pourrez extraire les données de l'utilisateur à volonté!
À titre d'exemple, examinons l'historique d'enregistrement. Grâce à ces quelques lignes de code, nous pouvons facilement extraire les derniers enregistrements de n'importe quel compte autorisé et les afficher à l'écran (ou éventuellement les stocker dans une base de données pour un accès facile!).
Nous définissons d'abord une variable unique $ fsqUsrHistory tenir notre objet d'histoire. Cela devrait renvoyer un tableau contenant des informations spécifiques sur chacune des archivages précédents du compte cible. Le PHP print_r () fonction affichera le tableau de réponses en texte clair à l’écran.
Conclusion
Cela a été un aperçu de base pour commencer à utiliser l’API de Foursquare. OAuth est un protocole ouvert très puissant pour la connexion à de plus grandes communautés sociales. Il offre les solutions les plus sécurisées pour les utilisateurs et les webmasters.
Si vous êtes toujours un peu perdu, il faut s'y attendre au début.Essayez de télécharger le package à partir de Github et de vous occuper de certains fichiers. Même des compétences rudimentaires en PHP suffiront pour travailler avec ces bibliothèques, il est donc difficile de tout gâcher.
Le centre des développeurs Foursquare est un outil extraordinaire pour les débutants. Parcourez les ressources, recherchez des appels de fonction avec lesquels vous pourriez être intéressé. De même, le site Web officiel d'OAuth propose d'excellentes lectures décrivant l'objectif et les solutions pratiques du protocole.