API 取得認證方式

API認證方式

• 須先取得 Refresh Token 及 Access Token 並放置於請求的 Header 中才能使用 API

• 請先透過API Token頁面取得Refresh Token

  • 使用者管理 -> API Token -> 新增設定

  • 圖片上第4點 API Endpoint 後面的網址是 CDN API Endpoint

  

• 點選 新增設定 以建立一組新的 API Token，TTL 代表的是 Access Token 的使用期限(秒)

  

• 建立後會出現 Refresh Token，請複製下來

  

  注意: Refresh Token 只會出現一次，請務必複製下來
• Access Token

  • 取得 Refresh Token 後，在過期前都可以透過 Refresh Token 取得 Access Token

• 以下是取得 Access Token 的範例

  • 當 Access Token 過期後，就必須透過此方法重新取得 Access Token

    curl --request GET \
      --header "SKC-RefreshToken: {Your Refresh Token}" \
      {CDN API Endpoint}/accessToken

  • Response: { "accessToken": "{Your Access Token}" }

• 使用API

  • 有了 Access Token 與 Refresh Token 後，就可以將這兩個 Token 帶上 HTTP Header 進行 CDN API 的操作，以下是取得用戶資訊的範例

    curl --request GET \
        --header "SKC-RefreshToken: {Your Refresh Token}" \
        --header "SKC-AccessToken: {Your Access Token}" \
        {CDN API Endpoint}/api/v1/user/account/self

  • Response: {"code": 101001, "data": { //ommited }}