免費參與·100+跨境活動 
免費下載·4000+跨境資料 
免費學習·2000+直播課程 
免費加入·15萬+賣家交流群 
2022-09-16 16:17
API是一種應用程序接口，通過API可提供傳輸數據和服務功能。快手海外商業平臺提供Reporting API開放能力，可為廣告主/代理商在自有平臺本地完成獲取廣告數據的功能。通過Reporting API功能客戶可以獲取廣告平臺的報表查詢功能，包括但不限campaign、ad sets、ads層級下的消耗、曝光、點擊、轉化等數據。
API接入流程：您（開發者）可以通過以下流程，進入賬號注冊平臺，創建開發者賬號、管理員為您添加開發者權限、申請應用并向客戶申請授權后，才可以通過API方式獲取相關數據。具體操作步驟如下：
Step 1: 開發者申請開發者賬號進入注冊頁面，點擊注冊，可創建開發者賬號。
Tips:
1、建議使用公司郵箱注冊，并妥善保管賬號及密碼
2、如當前已有kwai賬號，且非開發者角色（如當前賬號是優化師角色），暫時無法新增開發者角色
Step 2:
管理員為開發者創建角色第一步完成后，管理員進入Business Center后，選擇添加人員，完善人員信息，選擇開發者角色后，即完成了開發者身份注冊
Tips：
1、綁定的郵箱需與第一步中開發者申請的郵箱保持一致。
2、管理員為開發者選擇的團隊需與管理員所在團隊保持一致。
3、開發者角色和其他角色無法互換，也就是說開發者無法變更為其他角色，其他角色也無法表更為開發者角色，因此管理員在分配時需注意。
Step 3：開發者申請成為開發者第二步完成，即獲得開發者角色，進入business center申請成為開發者，需填寫以下信息。
● API Role：指開發者身份，廣告主or 代理商。
● Access Level：權限范圍。系統會根據開發者Role鑒權判定所擁有的API賬戶范圍。
● APP Name：開發者自定義
● Callback URL：回調地址，開發者自定義，用于授權成功后將授權碼回調給開發者，本期不支持更改，請務必填寫正確。
Tips：
1、開發者需要確保回調地址能夠成功接收回調信息。
2、本期僅支持一個開發者創建一個APP ID。
Step 4: 獲得應用（APP ID）平臺審核通過后，會返回APP ID信息：
● APP ID：開發者應用ID。每個開發者只允許創建一個APP ID，利用APPID和其他參數組合成授權URL，您就可以向廣告主發起授權申請了。
● Secret ID：應用密鑰。每個APPID都對應唯一密鑰，secret用于獲取access token以及獲取授權賬戶。
● Authorization URL：授權URL，授權鏈接的回調地址。
Step 5：獲得授權
● 復制授權url，在同一個瀏覽器打開新的tag 頁，將授權url（包含自定義參數）在地址欄中執行
● 瀏覽器按預留【回調地址】進行跳轉，并在跳轉后的url上拼接上【授權碼】和透傳的【自定義參數】
Step 6：獲取Acces Token
● 使用上一步獲得的授權碼，拼接獲取token請求：https://developers.kwai.com/oauth/token?grant_type=authorization_code&code={your auth code}&client_id={your client id}&client_secret={your secret key}&redirect_uri={your redirect url}
● 代碼中使用http client或類似http工具以GET請求方式觸發
● 如果所有參數參數正確，認證服務會返回一組token信息，
Step 7：獲取數據萬事俱備，接下來就通過API接口獲取數據吧
Step 8：刷新token
● refresh_token有效期默認半年
● 需要開發者自行判斷token過期時間，提前使用refresh_token換取新的token，才能繼續請求海外開放平臺接口，注意:請求里的參數必須和app 詳情里的內容一致，否則請求失敗
● refresh_token沒有失效的情況下，拼接刷新token請求，使用refresh_token重新獲取一組token即可
● refresh_token如果過期，只能重新走Step5 - 6獲取新的token、refresh_token
相關文章推薦：什么是Pixel，怎么創建Pixel
（來源：出海記事本）
以上內容屬作者個人觀點，不代表雨果跨境立場！如有侵權，請聯系我們。
