In diesem kurzen Tutorial werden wir die Manipulation von Websitedaten mit PHP untersuchen. Foursquare bietet einige großartige Tools für den Zugriff auf die API ihrer Website.
Wir arbeiten mit einer offenen Verbindungstechnologie OAuth, um Benutzer in unseren eigenen Foursquare-Apps von Drittanbietern zu authentifizieren!
Einchecken
Der jüngste Social Media-Wahnsinn im Internet konzentriert sich heute auf ortsbezogene soziale Netzwerke. Unternehmen wie Gowalla und vor allem Foursquare haben ein Check-In-System für soziale Netzwerke. Bei jedem Besuch Ihres örtlichen Einkaufszentrums, einer Pizza-Hütte, eines Parks oder einer Schule können Sie Ihren Status aktualisieren und Punkte sammeln, um Ausweise freizuschalten.
Das Netzwerk dreht sich um den Globus zu einem digitalen Spiel. Über die mobile App von Foursquare können Sie Ihr eigenes Benutzerkonto einrichten, Check-Ins auf Twitter oder Facebook aktualisieren, Fotos hochladen und vieles mehr! Die Zahl ist schnell gestiegen und die Gemeinschaft von Foursquare umkreist die Welt.
Ressourcen für Anfänger
Wenn Sie zum ersten Mal mit der Entwicklung von Anwendungsprogrammierschnittstellen beginnen, müssen Sie viele Hürden überwinden. In einigen fantastischen Artikeln finden Sie in Google-Suchen die Antwort auf viele grundlegende Fragen zu PHP- und API-Verbindungen.
Bei der Diskussion über die API von Foursquare empfehle ich das Google-Gruppenforum. Es enthält einige FAQ-Seiten und großartige Benutzerdiskussionen, die im Laufe der Zeit archiviert wurden. Insbesondere bieten sie die Web-API-Dokumentation auf eine elegante Art und Weise für Anfänger und Profis.
Für den Einstieg benötigen Sie ein einfaches PHP-Web-Setup. Wenn Sie über Remote-Server verfügen, können Sie alternativ alles anderswo hosten. Wenn Sie jedoch ungeduldig sind und keinen Internetzugang benötigen, ist die Installation einer lokalen Serverumgebung viel einfacher.
Für Windows und Mac funktionieren die WAMP- und MAMP-Pakete außerordentlich gut. Sie werden mit PHP- und MySQL-Datenbankfunktionen installiert, die unter der Apache-Webserver-Software ausgeführt werden.
Externe Bibliotheken und OAuth
Wir benötigen nur wenige externe Dateien, um effizient mit Foursquare arbeiten zu können. Beim Erstellen einer OAuth-Anwendung sind viele einfache Schritte erforderlich, um zu beginnen. Dies ist eine offene Plattform, die auf vereinfachten Standards basiert.
Nachfolgend finden Sie eine allgemeine Übersicht für eine OAuth-Verbindung:
- Anfrage erhalten Schlüssel und Geheimnis von der Foursquare API
- Fügen Sie den Anmelde- / Authentifizierungslink irgendwo auf der Website hinzu
- Benutzer klickt auf den Link. Wurde zu Foursquare geleitet und genehmigt / lehnt den Zugriff auf ihr Konto von einer Drittanbieteranwendung ab
- Speichern Sie jetzt gesichert Schlüssel und Geheimnis Anfragen aus der Foursquare-Datenbank aufrufen
Sie benötigen ein Foursquare-Konto, um an erster Stelle Ihren Schlüssel und Ihr Geheimnis zu erhalten. Es ist eine kostenlose Anmeldung, und wenn Sie an der API arbeiten möchten, haben Sie sich schon für die Anwendung interessiert! Nach dem Einloggen checken Sie das OAuth-Registrierungsformular aus, um Ihre neue App zu erstellen.
Sie müssen drei (3) Datenbits angeben, bevor Sie Ihren eindeutigen Schlüssel und Ihr geheimes Zeichenkettenpaar erhalten. Der App-Name, die Website-URL und die Rückkehr-URL. Die ersten beiden sind ziemlich selbsterklärend URL zurückgeben ist einfach die Seite, die Foursquare nach der Authentifizierung wieder in Richtung Benutzer umleitet.
Bibliotheken auswählen
Der letzte Schritt nach der Kontoerstellung besteht darin, herauszufinden, welche externen Bibliotheken verwendet werden sollen. Je einfacher und einfacher wir auf Daten zugreifen können, desto schneller läuft unsere Anwendung. Github ist eine fantastische Community, in der Entwickler ihre Codes mit der Welt teilen.
Insbesondere die Foursquare-Async-Bibliothek von Benutzer jmathai ist perfekt für das, was wir tun. Sie können das Paket direkt von dieser Seite herunterladen. Darin finden Sie einige Dateien, nämlich die Kernbibliotheken, mit denen wir arbeiten müssen. Nachfolgend aufgeführten:
- index.php
- callback.php
- EpiCurl.php
- EpiFoursquare.php
- EpiOAuth.php
In unserem index.php Datei Es gibt einige Felder, die etwas Eingaben erfordern. Oben haben wir zwei (2) Variablen mit dem Namen $ consumer_key und $ consumer_secret. Im Inneren möchten Sie den String-Wert auf das setzen, was Foursquare in Ihren OAuth-Anwendungseinstellungen festgelegt hat.
Die zweite Datei, die wir bearbeiten müssen, ist callback.php. Dadurch wird ein generischer Rückruf von Foursquare abgewickelt, und wir können Informationen über die Autorisierungsanfrage abrufen (Annahme / Ablehnung). Oben in dieser Datei sehen Sie dieselben Variablen, die dieselben Werte anfordern - scheinbar überflüssig, aber nützlich, um Skripts unabhängig zu halten.
Benutzerdaten ziehen
Laden Sie Ihre index.php Datei in einem beliebigen Browser von Ihrem lokalen Server. Sie sollten eine kleine Seite mit einem Anmelde-Link sehen. Wenn Sie auf diese Schaltfläche klicken, wird auf Foursquare umgeleitet, wo Sie die Verbindung zu Ihrer Anwendung zulassen oder ablehnen können. Nach der Annahme werden Sie zu Ihrer Callback-URL weitergeleitet und können nach Belieben Benutzerdaten abrufen!
Als kurzes Beispiel wollen wir die Check-in-Geschichte untersuchen. Durch diese wenigen Codezeilen können wir die letzten Check-Ins problemlos von jedem autorisierten Konto abrufen und auf dem Bildschirm anzeigen (oder sie für einen einfachen Zugriff in einer Datenbank speichern).
Wir setzen zunächst eine eindeutige Variable $ fsqUsrHistory unser geschichtliches Objekt halten. Dies sollte ein Array mit spezifischen Informationen zu jedem der vorherigen Checkins des Zielkontos zurückgeben. Das PHP print_r () Die Funktion zeigt das Antwortfeld in Klartext auf dem Bildschirm an.
Fazit
Dies war ein grundlegender Einblick in die ersten Schritte mit der API von Foursquare. OAuth ist ein sehr leistungsfähiges offenes Protokoll für die Verbindung mit größeren sozialen Gemeinschaften. Es bietet die sichersten Lösungen für Benutzer und Webmaster.
Wenn Sie noch ein bisschen verloren sind, ist das zunächst zu erwarten.Versuchen Sie, das Paket von Github herunterzuladen und einige der Dateien durcheinander zu bringen. Selbst rudimentäre PHP-Kenntnisse reichen aus, wenn Sie mit diesen Bibliotheken arbeiten.
Das Foursquare Developers Center ist ein erstaunliches Werkzeug für Neulinge. Durchsuchen Sie die Ressourcen und suchen Sie nach Funktionsaufrufen, mit denen Sie möglicherweise arbeiten möchten. In ähnlicher Weise enthält die offizielle OAuth-Website einige hervorragende Messwerte, die den Zweck und praktische Lösungen für das Protokoll beschreiben.