API 说明

最近更新时间:2024-08-23 14:15:03

我的收藏
SDK 接口除初始化接口,其余接口均由 HTTP 实现,请求格式为:
http:://${host}:${port}/${func}?${param}
其中 http://${host}:${port} 为本地代理服务器(即 XP2PService::host())。

统计

接口描述

描述:请求对应频道的统计数据
方法:GET
路径:/stat?xresid=${yourUrl}

请求参数

参数名称
必选
类型
说明
xresid
string
默认为 URL 中的 resource,如果有 xresid,则用 xresid,否则为频道的 encode url

返回参数

返回码
说明
查询成功
404
查询失败,频道不存在
其中,返回码 200 返回的 JSON 内容,格式详细说明如下:
参数名称
类型
说明
flow.p2pBytes
num
对应频道 P2P 流量
flow.cdnBytes
num
对应频道 CDN 流量

示例

请求示例:
http://127.0.0.1:16080/live.p2p.com/stat?xresid=${yourURL}
说明
xresid 即 http://127.0.0.1:16080/live.p2p.com/resoruce.ext 中的 resource。
返回示例:
"{"flow":{"p2pBytes":0,"cdnBytes":0}}"

设置上下行

接口描述

描述:请求设置 P2P 上行与下行,0为开启,1为关闭
方法:GET
路径:/feature?download=${0or1}&upload=${0or1}

请求参数

参数名称
必选
类型
说明
download
num
0为关闭;1为开启(默认值)
upload
num
0为关闭;1为开启(默认值

返回参数

返回的 JSON 内容,格式说明如下:
参数名称
必选
类型
说明
ret
num
0为正常
msg
string
相关信息, 调试使用
upload
bool
true 为开启,false 为关闭
download
bool
true 为开启,false 为关闭

示例

请求示例:
http://127.0.0.1:16080/live.p2p.com/feature?download=1&upload=0
说明
一般情况下移动网络可以关闭上传。
返回示例:
"{"ret":0, "msg":"ok", "download":0,"upload":0}}"