快速開始 之前的準備工作

  • 登入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
  }
}