BASE URL

• 廣州 https://cgi-cn.cdnbye.com/v1
• 香港 https://cgi.swarmcloud.net/v1
• 美國 https://cgi-us.swarmcloud.net/v1
• 歐洲 https://cgi-eu.swarmcloud.net/v1

限速: 2000次請求每分鐘

取得Token

取得目前帳戶的token

POST /user/token

請求主體

參數名	參數類型	描述	是否必要
email	string	使用者電子郵件	是
passwd	string	對原始密碼進行sha256加密後的字串	是

回應

Status: 200

{
  "ret": 0,
  "name": "token",
  "data":
    {
      "id": 001,
      "token": "xxxxxx"
    }
}

參數名	參數類型	描述
id	int	使用者ID
token	string	使用者token，有效期限14天

取得網域/AppId清單

取得某個使用者的所有網域/APP清單

GET /user/user_id/{user_id}/domain

HTTP請求標頭

參數名	參數類型	描述	是否必要
MyToken	string	使用者token	是

查詢參數

參數名	參數類型	描述	是否必要
page	int	目前頁數	是
page_size	int	每頁大小	是

回應

Status: 200

{
  "ret": 0,
  "name": "domain"
  "data":
    [
      {
        "id": 001,
        "domain": "xxx.com",
        "uid": 001,
        "native": false,
        "isValid": false
      }
    ]
}

參數名	參數類型	描述
id	int	網域/APP的ID
domain	string	網域/AppId
uid	int	使用者ID
native	bool	是否原生應用程式
isValid	bool	網域是否已綁定

設定時區

設定您所在時區的UTC偏移量

GET /user/user_id/{user_id}/timezone

HTTP請求標頭

參數名	參數類型	描述	是否必要
MyToken	string	使用者token	是

路徑參數

參數名	參數類型	描述	是否必要
user_id	string	使用者ID	是

請求主體

參數名	參數類型	描述	是否必要
utc	int	UTC偏移量	是

取得即時資料

取得某個或彙總的網域/APP的即時資料

GET /user/user_id/{user_id}/domain/domain_id/{domain_id}

HTTP請求標頭

參數名	參數類型	描述	是否必要
MyToken	string	使用者token	是

路徑參數

參數名	參數類型	描述	是否必要
user_id	string	使用者ID	是
domain_id	string	網域ID("0"代表取得所有網域/APP的彙總資料)	是

回應

Status: 200

{
  "ret": 0,
  "name": "domain",
  "data":
    {
      "num_rt": 456,
      "num_max": 892,
      "traffic_p2p_day": 1022794195,
      "api_frequency_day": 14805,
     }
}

參數名	參數類型	描述
num_rt	int	目前在線人數
num_max	int	歷史最高在線人數
traffic_p2p_day	int	今日P2P流量(KB)
api_frequency_day	int	今日播放次數

取得歷史P2P流量資料

取得某個指定時間段的P2P流量資料

GET /user/user_id/{user_id}/domain/domain_id/{domain_id}/p2p

HTTP請求標頭

參數名	參數類型	描述	是否必要
MyToken	string	使用者token	是

路徑參數

參數名	參數類型	描述	是否必要
user_id	string	使用者ID	是
domain_id	string	網域ID("0"代表取得所有網域/APP的彙總資料)	是

查詢參數

參數名	參數類型	描述	是否必要
start_ts	int	開始時間戳記(UTC+8)	是
end_ts	int	結束時間戳記(UTC+8)	是
gran	int	恆等於1440	是

回應

Status: 200

{
  "ret": 0,
  "name": "statistic",
  "data":
    {
      "max":
        {
          "ts": 1591372800,
          "value": 541188637412
        },
        "list":
          [
            {"ts":1590854400,"value":1591200000},
            {"ts":1590940800,"value":194511284034},
            {"ts":1591027200,"value":541188637412}
          ]
    }
}

參數名	參數類型	描述
max	object	歷史資料的最大值
list	array	所有歷史資料構成的陣列
ts	int	時間戳記
value	int	P2P流量(KB)

取得歷史在線人數資料

取得某個指定時間段的在線人數

GET /user/user_id/{user_id}/domain/domain_id/{domain_id}/num

HTTP請求標頭

參數名	參數類型	描述	是否必要
MyToken	string	使用者token	是

路徑參數

參數名	參數類型	描述	是否必要
user_id	string	使用者ID	是
domain_id	string	網域ID("0"代表取得所有網域/APP的彙總資料)	是

查詢參數

參數名	參數類型	描述	是否必要
start_ts	int	開始時間戳記(UTC+8)	是
end_ts	int	結束時間戳記(UTC+8)	是
gran	int	必須是5分鐘的整數倍	是

回應

Status: 200

{
  "ret": 0,
  "name": "statistic",
  "data":
    {
      "max":
        {
          "ts": 1591372800,
          "value": 109566
        },
        "list":
          [
            {"ts":1590854400,"value":66504},
            {"ts":1590940800,"value":72373},
            {"ts":1591027200,"value":78300}
          ]
    }
}

參數名	參數類型	描述
max	object	歷史資料的最大值
list	array	所有歷史資料構成的陣列
ts	int	時間戳記
value	int	在線人數

開啟/關閉 P2P

如果您在同一個帳號同時綁定了多個網域/APPID，則開啟P2P的所有網域/APPID會共享流量包。您可以在這裡關閉某個網域/APPID的P2P服務從而節省流量包消耗。

POST /user/user_id/{user_id}/domain/domain_id/{domain_id}/control

HTTP請求標頭

參數名	參數類型	描述	是否必要
MyToken	string	使用者token	Yes

路徑參數

參數名	參數類型	描述	是否必要
user_id	string	使用者ID	Yes
domain_id	string	網域ID	Yes

請求主體

參數名	參數類型	描述	是否必要
disable	bool	設定true關閉p2p或false開啟p2p	Yes

回應

Status: 200

{
  "ret":0,
  "name":"control",
  "data":
    {
      "allow":true,
      "succeed":true
    }
}