短網址生成API介面，短鏈生成 W外鏈API介面

微客云發表於2024-07-05
API

1、提供的介面

W外鏈提供介面如下：

  • 獲取短鏈分組
  • 建立短鏈分組
  • 獲取分組下的短鏈列表
  • 生成短鏈
  • 編輯短鏈
  • 刪除短鏈

2、簽名簡介

使用前請了解如下事項：

API 的簽名主要是用於獲取身份令牌 AccessToken 時所需必要認證引數
在請求需要複雜認證介面的時候，系統會驗證 AccessToken
在請求獲取 AccessToken 的介面時候，伺服器會對使用者請求合法性的 signature 進行檢查，以此來確定是否向使用者返回 AccessToken

獲取app id 和 app secret

進入後臺管理系統後，依次點選以下導航 短鏈/外鏈/開發API介面 管理獲取 app id 和 app secret

生成signature

一、組合簽名資料格式

{
    "app_id":"到後臺應用管理檢視app id",
    "app_secret":"到後臺應用管理檢視app secret",
    "sign_ver":"1.0",
    "timestamp":"當前系統時間戳"
}

二、根據欄位名降序排序，組合http原始字串

timestamp=1720144366&sign_ver=1.0&app_secret=xxxxxx&app_id=xxxxx

三、md5 http原始字串，完成生成 signature

2d41751369f4daaf9dd869aefa0da1e4

獲取AccessToken

  1. AccessToken 有效期只有 7200 秒，獲取後請快取到本地
  2. 有效期內再次請求的 AccessToken 會導致之前請求的全部失效
  3. 請使用伺服器端來做介面請求，客戶端會出現跨域等問題。
  4. 獲取 AccessToken 地址： https://api.wai.cn/api/v1/getAccessToken 請求方法： POST
{
    "app_id":"xxxx",
    "signature":"2d41751369f4daaf9dd869aefa0da1e4",
    "timestamp":128097733
}

3、使用須知

使用前請了解如下事項：

  1. API介面呼叫頻率暫時不限制。
  2. API介面僅供會員使用（使用前請先登入獲取APIKEY），非會員請使用控制檯操作。
  3. 每日可生成的短鏈數量上限與會員等級相關，具體上限請參照會員許可權。
  4. 短鏈本身的許可權與在網站控制檯生成的相同，均與賬號會員等級關聯。
  5. 您可以透過 「獲取短鏈分組介面」 來獲取連結分組，記錄下您需要的分組id，在程式碼中將該id寫死。
  6. 我們並不建議您在程式碼中透過「獲取短鏈分組介面」來動態指定id，除了「生成短連結口」次數限制與會員許可權關聯外，其餘介面均有每日呼叫次數限制，詳見各介面文件。

相關文章