快速開始 之前的準備工作
- 登入SkyID
- 申請一組App
1. 在App設定裡輸入【重新導向網址】
【重新導向網址】為使用者透過SkyID登入後,SkyID會將使用者的瀏覽器重新導向回您的頁面,此時SkyID會將使用者的有效access_token帶在頁面後的參數回傳,讓您可以透過此access_token進行後續SkyID API的操作。
2. 在App設定畫面中,取得client_id與client_secret
SkyID是以client_id來辨識App,而client_secret則是存取部分SkyID API時的必要值,client_secret請勿公開,請不要把client_secret寫在前端HTML或Javascript裡。
3. 設定您網站上的登入按鈕
當使用者點擊登入鈕時,請將頁面導向到
https://skyid.cc/auth?client_id=
${client_id}
&redirect_uri=${redirect_uri}
其中${client_id}就是您在App設定畫面裡取得的client_id,${redirect_uri}則是您設定好的重新導向網址。
4. 從重新導向網址取得access_token
使用者登入成功後,SkyID會把網頁導回到
${redirect_uri}
?access_token=${access_token}
您可以藉著這個機會取得使用者的access_token。
每個使用者的access_token都不同。
5. 取得使用者資料
若是您需要取得使用者的資料,或是您想確認使用者的access_token是否合法,可以呼叫以下的API:
[GET]
https://skyid.cc/api/1.0/user/me?access_token=${access_token}
這支API將會驗證access_token並回傳該使用者的相關資訊,回傳資料格式如下:
{ status:'OK', data: { sky_id: 'd856807eaBkJv433eG', name: 'John Smith', email: 'john@skyid.cc', method: 'facebook', platform_token: 'the_access_token_from_facebook', exp: 1571641041 } }