跳到內容
Academy

認證

應用程式會提供您一組 Client ID 和 Secret Key，您需要使用它們來建立一個已認證的 OAuth2 會話，以便與 Wink 和 TripPay API 進行通訊。

以下是建立已認證會話的步驟。

步驟 1. 在測試環境或正式環境中取得存取權杖：

您很可能會使用適用於您程式語言的強大 OAuth2 函式庫，該函式庫會為您處理所有繁重的工作。 我們的範例將展示使用 curl 從命令列進行最基本的操作。

測試環境

Section titled “測試環境”
Terminal window
curl -X POST https://staging-iam.wink.travel/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=<YOUR_CLIENT_ID>" \
  -d "client_secret=<YOUR_SECRET_KEY>"

正式環境

Section titled “正式環境”
Terminal window
curl -X POST https://iam.wink.travel/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=<YOUR_CLIENT_ID>" \
  -d "client_secret=<YOUR_SECRET_KEY>"

這將回傳一個存取權杖，以及其他 OAuth2 回應資料：

{
  "access_token": "abc123"
}

當您呼叫我們的任何端點時，請在標頭中包含以下內容：

  • Wink-Version = 2.0 最新版本 - 請參閱我們的 API 文件了解其他可用版本。
  • Authentication = Bearer: ${access_token} 插入您的存取權杖。