In questo breve tutorial esamineremo la manipolazione dei dati del sito web con PHP. Foursquare offre alcuni ottimi strumenti per accedere alle API del proprio sito Web.
Lavoreremo con una tecnologia di connessione aperta OAuth per autenticare gli utenti nelle nostre app Foursquare di terze parti!
Check-in
L'ultima moda dei social media sul web oggi è incentrata sul social networking basato sulla posizione. Aziende come Gowalla e in particolare Foursquare scappano da un sistema di check-in della rete sociale. Per ogni visita al tuo centro commerciale, pizza baracca, parco o scuola puoi aggiornare il tuo stato e guadagnare punti per sbloccare i badge.
La rete ruota attorno al globo in un gioco digitale di sorta. Attraverso l'app mobile di Foursquare è possibile eseguire il proprio account utente, aggiornare i check-in su Twitter o Facebook, caricare foto e molto altro ancora! I numeri sono cresciuti rapidamente e la comunità di Foursquare circola nel mondo.
Risorse per principianti
Quando inizi a sviluppare le interfacce di programmazione delle applicazioni, ci sono molti ostacoli da superare. Attraverso alcuni fantastici articoli le ricerche di Google contengono la risposta a molte delle domande di base sulle connessioni PHP e API.
Quando si discute dell'API di Foursquare, consiglio vivamente il forum dei gruppi di Google. Viene fornito con alcune pagine FAQ e ottime discussioni con gli utenti archiviate nel tempo. Più specificamente offrono la documentazione dell'API Web in modo elegante sia per i principianti che per i professionisti.
Per iniziare avrai bisogno di una semplice configurazione web PHP. Se hai spazio su server remoto, puoi alternativamente ospitare tutto altrove. Tuttavia, se sei impaziente e non hai bisogno di accedere a Internet, è molto più semplice installare un ambiente server locale.
Per Windows e Mac i pacchetti WAMP e MAMP funzionano molto bene. Si installano con funzionalità di database PHP e MySQL in esecuzione con il software del server Web Apache.
Librerie esterne e OAuth
Abbiamo solo bisogno di alcuni file esterni per lavorare con Foursquare in modo efficiente. Quando si crea un'applicazione OAuth sono necessari molti semplici passaggi per iniziare. Questa è una piattaforma aperta costruita tenendo presenti gli standard semplicistici.
Di seguito è riportata una panoramica generale per una connessione OAuth:
- Ottenere la richiesta chiave e segreto dall'API di Foursquare
- Aggiungi il link di login / autenticazione da qualche parte sul sito web
- Link click dell'utente. Diretto a Foursquare e approva / rifiuta l'accesso al proprio account dall'applicazione di terzi
- Negozio ora protetto chiave e segreto chiamare le richieste dal database di Foursquare
Avrai bisogno di un account Foursquare per ottenere la chiave e il segreto in primo luogo. È una registrazione gratuita e, se desideri lavorare sull'API, sono sicuro che hai già avuto un interesse per l'applicazione! Una volta effettuato l'accesso, controlla il modulo di registrazione OAuth per creare la tua nuova app.
Dovrai fornire tre (3) bit di dati prima di ottenere la tua chiave univoca e la coppia di stringhe segrete. Nome dell'app, URL del sito Web e URL di ritorno. I primi due sono abbastanza auto-esplicativi mentre il URL di ritorno è semplicemente la pagina in cui Foursquare reindirizza gli utenti verso il completamento dell'autenticazione.
Picking Libraries
Il passaggio finale dopo la creazione dell'account è capire quali librerie esterne utilizzare. Più semplice e facile possiamo accedere a bit di dati, più veloce sarà la nostra applicazione. Github è una comunità fantastica in cui gli sviluppatori condividono i loro bit di codice con il mondo.
In particolare la libreria async Foursquare di jmathai dell'utente è perfetta per quello che stiamo facendo. Puoi scaricare il pacchetto direttamente da quella pagina. All'interno troverai alcuni file, vale a dire le librerie di base con cui dovremo lavorare. Elencati di seguito:
- index.php
- callback.php
- EpiCurl.php
- EpiFoursquare.php
- EpiOAuth.php
Dentro il nostro index.php file ci sono alcuni campi che richiedono qualche input. Verso l'alto abbiamo due (2) variabili nominate $ consumer_key e $ consumer_secret. All'interno dovrai impostare il valore della stringa su qualsiasi Foursquare impostato nelle impostazioni dell'applicazione OAuth.
Il secondo file che dobbiamo modificare è callback.php. Questo gestirà un richiamo generico da Foursquare e ci consentirà di estrarre informazioni sulla richiesta di autorizzazione (accettazione / rifiuto). Verso l'alto di questo file vedrete le stesse variabili che richiedono lo stesso set di valori - apparentemente ridondanti, ma utili per mantenere indipendenti gli script.
Tirare i dati dell'utente
Prova a caricare il tuo index.php file all'interno di qualsiasi browser dal tuo server locale. Dovresti vedere una piccola pagina con un link di accesso - facendo clic su questo reindirizzerai su Foursquare dove puoi scegliere di consentire o negare la connessione alla tua applicazione. Dopo l'accettazione verrai reindirizzato verso il tuo URL di callback e potrai estrarre i dati dell'utente a piacimento!
Come un breve esempio esaminiamo la cronologia del check-in. Attraverso queste poche righe di codice possiamo facilmente estrarre gli ultimi controlli da qualsiasi account autorizzato e visualizzarli sullo schermo (o eventualmente memorizzarli in un database per un facile accesso!)
Per prima cosa impostiamo una variabile unica $ fsqUsrHistory per mantenere il nostro oggetto storico. Questo dovrebbe restituire un array contenente informazioni specifiche su ciascuno dei precedenti controlli dall'account di destinazione. Il PHP print_r () la funzione mostrerà la matrice di risposta in chiaro sullo schermo.
Conclusione
Questo è stato un aspetto fondamentale dell'inizio dell'API di Foursquare. OAuth è un protocollo aperto molto potente per connettersi a comunità sociali più grandi. Offre le soluzioni più sicure per utenti e webmaster.
Se sei ancora un po 'perso, è prevedibile all'inizio.Prova a scaricare il pacchetto da Github e fai confusione con alcuni dei file. Anche le competenze di PHP rudimentali saranno sufficienti quando si lavora con queste librerie, quindi è difficile fare confusione.
Il centro per sviluppatori Foursquare è uno strumento straordinario per i neofiti. Scorri le risorse e cerca e chiama le chiamate con cui potresti essere interessato a lavorare. Allo stesso modo il sito ufficiale di OAuth ha delle letture formidabili che descrivono lo scopo e le soluzioni pratiche per il protocollo.