Skip to content

api.md

Latest commit

 

History

History
1329 lines (1043 loc) · 29.5 KB

api.md

File metadata and controls

1329 lines (1043 loc) · 29.5 KB

市场部直播APP应用接口说明

版本号：v1.0.2

接口规范

协议

HTTP/1.1

请求方法

GET

一般在请求服务器资源时使用。

包含参数时,参数一律以 Query String 的形式传递，示例可参考**获取我的信息** API。

POST

一般在操作服务器资源时使用。

包含参数时，请求头需添加Content-Type: application/json，参数一律以 JSON 格式在请求体中传递，示例可参考**根据手机验证码登录**API。

鉴权

TODO 添加加密Token机制

用户登录后的所有操作都需要经过鉴权，鉴权方式使用 HTTP Basic Auth。

用户在登录成功后，服务器会返回唯一的api_token。之后客户端的每一次请求都需要在请求头中携带经过 Base64 编码的api_token，形式为：Authorization: base64encode(api_token:)。

令牌生命周期

令牌生命周期是指一个用户自登录之后所获得的令牌的有效时长。

V1.0.0版本中设计为：一个令牌自颁发以后，除非用户主动注销或者重新登录，否则一直有效。

响应

服务器一旦接受了客户端的请求，一定会返回状态为200 OK的 HTTP 响应，但请求执行结果需要根据响应内容来进行判断。

响应内容的格式一律为 JSON，并一定包含两个基本的状态码code和desc。code是服务器制定的状态编码，用于指示本次返回请求所对应的结果；desc是对code的描述，用于帮助客户端的开发人员直观的理解code的含义而无需查表。

例如，当因为没有携带授权信息而导致请求失败时，会返回：

{
	"code": 4010,
	"desc": "unauthorized"
}

当成功时，则返回的数据中一定包含以下两项内容，以及根据不同的API规范而返回的不同数据结构：

{
	"code": 2000,
	"desc": "ok"
}

全部的状态码请参考状态码列表。 全部的API接口请参考API列表

状态码

状态码 返回值code 默认描述desc 说明
API_OK 2000 ok 成功
API_BAD_REQUEST 4000 bad request 请求的参数缺失或格式不符
API_UNAUTHORIZED 4010 unauthorized 未授权，一般是因为api_token不正确
API_INVALID_AUTH_CODE 4011 invalid auth code 错误的登录验证码
API_OAUTH_FAIL 4012 oauth fail OAuth登录失败
API_USER_BANNED 4013 user is banned 用户被禁用
API_MAX_CHANNEL_TOUCHED 4031 touch maximum number of channels 达到最大频道数量
API_MESSAGE_TOO_FREQUENTLY 4032 send meesage too frequently 发送消息频率太快
API_CHANNEL_INACCESSIBLE 4033 channel is inaccessible 频道不处于推流中或结束推流的状态，不可访问
API_CHANNEL_ALREADY_FINISHED 4034 channel is already finished 频道已经处于街退推流的状态，不可访问；这个响应码会在试图访问一个实际已经结束推流、但是业务上没有来得及记录的频道时抛出
API_USER_NOT_FOUND 4041 user not found 用户未找到
API_CHANNEL_NOT_FOUND 4042 channel not found 频道未找到

API

目录

登录

 Github OAuth方式登录

客户端应使用WebView请求本 API，请求后会跳转到 Github 的 OAuth 登录页面供用户登录，用户操作后会产生响应结果。

请求

GET /users/login/github

成功

返回html页面:"5秒后自动跳转"

失败

API_BAD_REQUEST
API_OAUTH_FAIL

 Qiniu OAuth方式登录

客户端应使用WebView请求本 API，请求后会跳转到 Qiniu Portal 的 OAuth 登录页面供用户登录，用户操作后会产生响应结果。

请求

GET /users/login/qiniu

成功

返回html页面:"5秒后自动跳转"

失败

API_BAD_REQUEST
API_OAUTH_FAIL

 登录

请求

POST /users/login
Content-Type: application/json

{
	"auth_code": <string auth_code>,
	"getui_cid": <string getui_cid>
}
  • auth_code： string类型，OAuth成功后返回的auth_code，一经登录即作废。
  • getui_cid ： string类型，app在初始化之后获得的个推cid（clientid）

成功

{
  "code": 2000, 
  "desc": "ok", 
  "user": <user user>,
  "api_token": <string api_token>, 
  "rong_cloud_token": <string rong_cloud_token>
}
  • user： user类型（定义），当前用户
  • api_token： string类型，用户本次生命周期中用于鉴权的秘钥
  • rong_cloud_token： int类型，融云的token

失败

API_BAD_REQUEST
API_INVALID_AUTH_CODE

 登出

请求

POST /users/logout
Authorization: Basic Auth

成功

{
	"code": 2000,
	"desc": "ok"
}

失败

API_UNAUTHORIZED

用户相关

 类型声明：user

在返回结果中，user的格式如下：

{
	"id": <int id>,
	"name": <string name>,
	"nickname": <strng nickname>,
	"bio": <string bio>,
	"gender": <int gender>,
	"email": <string email>,
	"mobile": <string mobile>,
	"avatar": <string avatar>,
	"qiniu_name": <string qiniu_name>,
	"qiniu_email": <string qiniu_email>,
	"github_login": <string github_login>,
	"github_name": <string github_name>,
	"github_email": <string github_email>,
	"is_banned": <int is_banned>,
	"like_count": <int like_count>,
	"followed_count": <int followed_count>,
	"follower_count": <int follower_count>,
	"is_followed": <bool is_followed>
}
  • id： int类型，用户id
  • name： string类型，用户名称
  • nickname： string类型，用户昵称
  • bio： string类型，用户个人签名
  • gender： int类型，用户的性别
    • 0：secret
    • 1：male
    • 2：female
  • email： string类型，用户的电子邮箱（优先级：七牛帐号对应邮箱 > Github帐号对应邮箱）
  • mobile： string类型，用户的手机号
  • avatar： string类型，用户的头像对应的url
  • qiniu_name： string类型，用户通过Qiniu OAuth登陆后获得的名称
  • qiniu_email： string类型，用户通过Qiniu OAuth登陆后获得的邮箱
  • github_login： string类型，用户通过Github OAuth登陆后获得的登陆名
  • github_name： string类型，用户通过Github OAuth登陆后获得的名称
  • github_email： string类型，用户通过Github OAuth登陆后获得的邮箱
  • is_banned： bool类型，用户是否被禁用
    • true：禁用状态
    • false：可用状态
  • like_count：点赞数
  • followed_count：关注的人的数量
  • follower_count：粉丝数量
  • is_followed：当前用户是否关注该用户

 获取用户信息

请求

GET /users?id=<id>&nickname=<nickname>&p=<p>&l=<l>
Authorization: Basic Auth
  • id： int类型，用户id，可选
  • nickname： string类型，用户昵称，可选
  • p： int类型，分页中的页数page，默认为1
  • l： int类型，分页中的限制limit，默认为10

成功

{
	"code": 2000,
	"desc": "ok",
	"users": [
		<user user1>,
		<user user2>,
		...
	]
}
  • users：user类型（定义）的列表，符合查询条件的用户列表

失败

API_UNAUTHORIZED
API_USER_NOT_FOUND

 获取我的用户信息

请求

GET /users/my
Authorization: Basic Auth

成功

{
	"code": 2000,
	"desc": "ok",
	"user": <user>
}
  • user：user类型（定义），当前用户信息

失败

API_UNAUTHORIZED

 更新我的用户信息

POST /users/my
Authorization: Basic Auth
Content-Type: application/json

{
    "avatar": <string avatar>,
    "nickname": <string nickname>,
    "gender": <int gender>,
    "bio": <string bio>,
    "email": <string email>,
    "mobile": <string mobile>
}
  • avatar：string类型，用户头像，可选
  • nickname： string类型，用户昵称，可选
  • gender： int类型，用户性别（定义），可选
  • bio： string类型，用户简介，可选
  • email：string类型，用户邮箱，可选
  • mobile：string类型，用户手机，可选

成功

{
	"code": 2000,
	"desc": "ok",
	"user": <user>
}
  • user：user类型（定义），更新后的当前用户信息

失败

API_UNAUTHORIZED
API_BAD_REQUEST

 关注用户

POST /users/follow/<int id>
Authorization: Basic Auth
  • id： int类型，要关注的用户id

成功

{
	"code": 2000,
	"desc": "ok",
}

失败

API_UNAUTHORIZED
API_USER_NOT_FOUND
API_BAD_REQUEST
  • API_BAD_REQUEST： 当前用户已经关注该用户

 取消关注用户

POST /users/unfollow/<int id>
Authorization: Basic Auth
  • id： int类型，要取消关注的用户id

成功

{
	"code": 2000,
	"desc": "ok",
}

失败

API_UNAUTHORIZED
API_USER_NOT_FOUND
API_BAD_REQUEST
  • API_BAD_REQUEST： 当前用户并未关注该用户

 获取关注用户列表

GET /users/follows/<int id>?p=<p>&l=<l>
Authorization: Basic Auth
  • id： int类型，要获取关注用户列表的用户id
  • p： int类型，分页中的页数page，默认为1
  • l： int类型，分页中的限制limit，默认为10

成功

{
	"code": 2000,
	"desc": "ok",
	"count": <int count>
	"users":[
		{
	 		"user": <user>,
			...
		}
	]

}
  • count： int类型，获取到的用户数量
  • user：user类型（定义）

失败

API_UNAUTHORIZED
API_USER_NOT_FOUND

 获取粉丝列表

GET /users/followers/<int id>?p=<p>&l=<l>
Authorization: Basic Auth
  • id： int类型，要获取粉丝列表的用户id
  • p： int类型，分页中的页数page，默认为1
  • l： int类型，分页中的限制limit，默认为10

成功

{
	"code": 2000,
	"desc": "ok",
	"count": <int count>
	"users":[
		{
	 		"user": <user>,
			...
		}
	]

}
  • count： int类型，获取到的用户数量
  • user：user类型（定义）

失败

API_UNAUTHORIZED
API_USER_NOT_FOUND

频道相关

 类型声明：channel

在返回结果中，channel的格式如下：

{
	"id": <int id>,
	"title": <string title>,
	"thumbnail": <string thumbnail>,
	"desc": <string desc>,
  	"duration": <int duration>,
  	"orientation": <int orientation>,
  	"quality": <int quality>,
  	"status": <int status>,
  	"is_banned": <bool is_banned>,
  	"is_deleted": <bool is_deleted>,
  	"owner": <user owner>,
  	"visit_count": <int visit_count>,
  	"like_count": <int like_count>,
	"started_at": <timestamp statred_at>,
  	"stopped_at": <timestamp stopped_at>,
  	"created_at": <timestamp created_at>
	"is_liked": <bool is_liked>,
	"live_time": <int live_time>,
	"online_nums": <int online_nums>,
	"playback": <string playback>,
	"live": {
		"flv": "http://xxxxx/hub/stream-id.flv",
		"hls": "http:/xxxxx/hub/stream-id.m3u8",
	  	"rtmp": "rtmp://xxxxx/hub/stream-id"
	}
  • id： int类型，频道id
  • title： string类型，频道标题
  • thumbnail： string类型，频道缩略图对应url
  • desc： string类型，频道描述
  • duration： int类型，频道的持续时间，单位秒。未结束时为None
  • orientation： int类型，屏幕方向，由前端给出
  • quality： ini类型，画质，由前端给出
  • status： int类型，频道状态
    • 0：新建，尚未推流
    • 1：推流中
    • 3：已结束推流
  • is_banned： bool类型，频道是否已经被禁止
  • is_deleted： bool类型，频道是否已经被删除
  • owner：user类型（定义），频道的拥有者
  • visit_count： int类型，当前频道被点击的数目
  • like_count： int类型，当前频道被点赞的数目
  • started_at： timestamp类型，开始推流的时间
  • stopped_at： timestamp类型，结束推流的时间
  • created_at： timestamp类型，频道创建的时间
  • is_liked： bool类型，当前用户是否已点赞该频道
  • live_time： int类型，从直播开始到现在过去的秒数，如果不在直播中，为null
  • online_nums： int类型，当前观看直播的人数，如果不在直播中，为null
  • playback ： string类型，回放地址，如果正在直播，为null

频道状态

在目前的设计（v1.0.1）中，频道有三种可能的状态：

  • initiate： 新建状态，这时用户还没有提起推流请求。一个用户只可能拥有至多一个处于initiate状态的频道，一旦一个频道被新建了但是没有进行推流，它将会在下一个新建频道的请求到来后被删除。

  • publishing： 正在推流状态。只有一个处于initiate状态的频道可以被提出推流申请，对任何非initiate状态的频道提出推流申请都将被服务器拒绝。一个用户只可能拥有至多一个处于publishing状态的频道，此后任何新的对该用户的initiate状态频道的推流申请都将强制打断当前处于publishing状态的这个频道。

  • published： 结束推流状态。只有一个处于publishing状态的频道可以被提出结束推流申请。一个用户可以拥有多个处于published状态的频道。

 类型声明：stream

stream是由 pili 服务器返回的模型。在返回结果中，stream的格式形如：

{
	"createdAt": "2015-12-23T16:23:33.086+08:00",
	"disabled": false,
	"disabledTill": 0,
	"hosts": {
		"live": {
			"hdl": "pili-live-hdl.live.golanghome.com",
			"hls": "pili-live-hls.live.golanghome.com",
			"http": "pili-live-hls.live.golanghome.com",
			"rtmp": "pili-live-rtmp.live.golanghome.com"
		},
		"play": {
			"http": "pili-live-hls.live.golanghome.com",
			"rtmp": "pili-live-rtmp.live.golanghome.com"
		},
		"playback": {
			"hls": "pili-playback.live.golanghome.com",
			"http": "pili-playback.live.golanghome.com"
		},
		"publish": {
			"rtmp": "pili-publish.live.golanghome.com"
		}
	},
	"hub": "jinxinxin",
	"id": "z1.jinxinxin.567a5a05d409d266f3000003",
	"publishKey": "7a2f7f10cab7a706",
	"publishSecurity": "static",
	"title": "567a5a05d409d266f3000003",
	"updatedAt": "2015-12-23T16:23:33.086+08:00"
}

 创建频道

请求

POST /channels
Authorization: Basic Auth
Content-Type: application/json

{
	"title": <string title>,
	"quality": <int quality>,
	"orientation": <int orientation>
}
  • title： string类型，频道的标题，必选
  • quality： int类型，直播的清晰度，可选
  • orientation： int类型，直播的屏幕方向，可选

成功

{
	"code": 2000,
	"desc": "ok",
	"channel": <channel>,
	"stream": <stream>
}
  • channel： channel类型，本次创建的频道信息，定义见这里
  • stream： stream类型，本次创建的频道对应的流信息，定义见这里

失败

API_UNAUTHORIZED
API_BAD_REQUEST
API_MAX_CHANNEL_TOUCHED

 获取直播频道列表

请求

GET /channels/live?type=<type>&p=<p>&l=<l>
Authorization: Basic Auth
  • p： int类型，分页中的页数page，默认为1
  • l： int类型，分页中的限制limit，默认为10

成功

{
	"code": 2000,
	"desc": "ok",
	"count": <int count>,
	"channels":[
		{
	 		"channel": <channel>,
	 		...
		}
	]
}
  • count： int类型，获取到的频道数量
  • channel： channel类型，本次创建的频道信息，定义见这里

失败

API_UNAUTHORIZED

 获取回放频道列表

本接口可以使用type参数来规定查找的回放频道列表的排序依据

请求

GET /channels/playback?type=<type>&p=<p>&l=<l>
Authorization: Basic Auth
  • type：int类型，默认为1（0=最热，1=最新，2=关注）
  • p：int类型，分页中的页数page，默认为1
  • l：int类型，分页中的限制limit，默认为10

成功

{
	"code": 2000,
	"desc": "ok",
	"count": <int count>,
	"channels":[
		{
	 		"channel": <channel>,
			...
		}
	]
}
  • count：int类型，获取到的频道数量
  • channel：channel类型，本次创建的频道信息，定义见这里

失败

API_UNAUTHORIZED

 获取指定用户的全部频道列表

请求

GET /channels/all?owner_id=<owner_id>&status=<status>&p=<p>&l=<l>
Authorization: Basic Auth
  • owner_id：int类型，频道属主id，可选
  • status： int类型，频道状态。可选，默认为 publishing和published，可选二者其一，具体可参考频道状态
  • p： int类型，分页中的页数page，默认为1
  • l： int类型，分页中的限制limit，默认为10

成功

{
	"code": 2000,
	"desc": "ok",
	"count": <int count>,
	"channels":[
		{
	 		"channel": <channel>,
			...
		}
	]
}
  • count： int类型，获取到的频道数量
  • channel： channel类型，本次创建的频道信息，定义见这里

失败

API_UNAUTHORIZED

 访问指定频道

请求

POST /channels/access/<int id>
Authorization: Basic Auth
  • id： int类型，要访问的频道id

成功

{
	"code": 2000,
	"desc": "ok",
	"channel": <channel channel>
}
  • channel： channel类型，本次创建的频道信息，定义见这里

失败

API_UNAUTHORIZED
API_CHANNEL_NOT_FOUND
API_CHANNEL_INACCESSIBLE

 检查频道的流状态

请求

GET /channels/stream/<int id>
Authorization: Basic Auth
  • id： int类型，要查询流信息的频道id

成功

{
	"code": 2000,
	"desc": "ok",
	"disabled": <bool disable>,
	"status": <string status>
}
  • disable， bool类型，表示流是否被禁止
  • status， string类型，connected | disconnected

失败

API_UNAUTHORIZED
API_CHANNEL_NOT_FOUND
API_BAD_REQUEST

 频道点赞

请求

POST /channels/like/<int id>
Authorization: Basic Auth
  • id： int类型，要点赞的频道id

成功

{
	"code": 2000,
	"desc": "ok",
}

失败

API_UNAUTHORIZED
API_CHANNEL_NOT_FOUND
API_BAD_REQUEST
API_CHANNEL_INACCESSIBLE
  • API_BAD_REQUEST： 当前用户已经对该频道点赞

 取消频道点赞

请求

POST /channels/dislike/<int id>
Authorization: Basic Auth
  • id： int类型，要取消点赞的频道id

成功

{
	"code": 2000,
	"desc": "ok",
}

失败

API_UNAUTHORIZED
API_CHANNEL_NOT_FOUND
API_BAD_REQUEST
API_CHANNEL_INACCESSIBLE
  • API_BAD_REQUEST： 当前用户并没有对该频道点赞

 举报频道

请求

POST /channels/complain/<int id>
Authorization: Basic Auth
Content-Type: application/json

{
	"reason": <string reason>
}
  • id： int类型，要投诉的频道id
  • reason： string类型，投诉理由，必须

成功

{
	"code": 2000,
	"desc": "ok",
}

失败

API_UNAUTHORIZED
API_CHANNEL_NOT_FOUND
API_BAD_REQUEST
API_CHANNEL_INACCESSIBLE

 分享频道

分享url：/channels/share/<int channel_id>

 删除频道

请求

POST /channels/delete/<int id>
Authorization: Basic Auth
  • id： int类型，要删除的频道id

成功

{
	"code": 2000,
	"desc": "ok",
}

失败

API_UNAUTHORIZED
API_CHANNEL_NOT_FOUND

消息相关

 类型声明 message

在返回的结果中，message的格式如下：

{
	"id": <int id>,
	"content": <string content>,
	"offset": <int offset>,
	"author": {
		"id": <int user_id>,
		"nickname": <string nickname>,
		"avatar": <string avatra>
	},
	"channel_id": <int channel_id>
}
  • id：int类型，消息的id
  • content：string类型，消息内容
  • offset：int类型，相对于频道开始时间的偏移，单位秒
  • author：发送消息的用户基本信息
    • user_id：int类型，用户的id
    • nickname：string类型，用户的昵称
    • avatar：string类型，用户的头像url
  • channel_id：int类型，消息归属的频道id

 发送消息

请求

POST /channels/messages/<int id>
Authorization: Basic Auth
Content-Type: application/json

{
	"content": <string content>,
	"offset": <int offset>
}
  • id： int类型，要发送消息的频道id
  • content： string类型，消息内容，必须
  • offset： int类型，当对应的频道处于已结束推流状态时，必须

成功

{
	"code": 2000,
	"desc": "ok",
}

如果频道处于直播状态，发送的消息的extra中还会包含用户名称和头像信息，格式如下：

{
	"name": <string name>,
	"avatar": <string avatar>
}
  • name： string类型，消息发送者的名称
  • avatar： string类型，消息发送者的头像url

失败

API_UNAUTHORIZED
API_CHANNEL_NOT_FOUND
API_BAD_REQUEST
API_CHANNEL_INACCESSIBLE
API_MESSAGE_TOO_FREQUENTLY

 获取频道中的消息

请求

GET /channels/messages/<int id>?s=<s>&o=<o>&l=<l>
Authorization: Basic Auth
  • id： int类型，要发送消息的频道id
  • s： int类型，要获取对应视频第s秒的字幕，默认为1，单位秒
  • o： int类型，要获取包括第s秒在内，往后o秒的字幕，默认为10，单位秒
  • l： int类型，每秒最大的字幕数目，默认为100

参数解释

假设s=31，o=30，l=5，则它们组合起来的含义是：要获取对应视频第31(s)秒开始的总共30(o)秒的字幕列表(即31-60秒的字幕)，每秒最多只返回最新的5个(l)。

成功

{
	"code": 2000,
	"desc": "ok",
	"count": <int count>,
	"messages": {
	    '<int offset1>': [
	    	<message>,
	    	<message>,
	    	...
	    ]
	},
	"start": <int start>,
	"offset": <int offset>,
	"limit": <int limit>
}
  • count： int类型，查询返回的消息数量
  • messages： Map类型，查询返回的所有消息列表，对于其中的每一个键值对，**key是offset，value为对应该offset的所有消息列表。消息列表的类型是Array，其中每一个元素都为消息类型。
  • start： int类型，对应请求的s参数，即本次请求的上下文，方便调试
  • offset： int类型，对应请求的o参数，即本次请求的上下文，方便调试
  • limit： int类型，对应请求的l参数，即本次请求的上下文，方便调试

失败

API_UNAUTHORIZED
API_CHANNEL_NOT_FOUND
API_BAD_REQUEST
API_CHANNEL_INACCESSIBLE

其他

 反馈

请求

POST /feedback
Authorization: Basic Auth
Content-Type: application/json

{
	"content": <string content>,
	"email": <string email>,
	"mobile": <string mobile>
}
  • content： string类型，反馈内容，必须
  • email： string类型，反馈人邮箱，必须
  • mobile： string类型，反馈人电话，可选

成功

{
	"code": 2000,
	"desc": "ok",
}

失败

API_UNAUTHORIZED
API_BAD_REQUEST

 类型声明 notify

在返回的结果中，notify的格式如下：

{
	"id": <int id>,
	"title": <string title>
	"thumbnail": <string thumbnail>
	"brief": <string content>,
	"noticed_at": <timestamp noticed_at>,
	"is_read": <bool is_read>
}
  • id：int类型，通知的id
  • title ： string类型，通知的标题
  • thumbnail： string类型，通知的缩略图，如果没有则为null
  • brief： string类型，通知的摘要
  • noticed_at：timestamp类型，通知发布的时间
  • is_read：bool类型，当前用户是否已读该消息

 获取通知列表

本接口有两种使用方法：

  1. 请求时携带all参数并置为1，这样接口将返回自用户注册时间之后的所有消息；
  2. 请求时不携带all参数，这样接口将只返回上次调用该接口的时间之后的消息；

请求

GET /notifies?all=<all>&p=<p>&l=<l>
Authorization: Basic Auth
  • all： int类型，默认为0，表示用法二；置为1时，表示用法一
  • p： int类型，分页中的页数page，默认为1
  • l： int类型，分页中的限制limit，默认为10

成功

{
	"code": 2000,
	"desc": "ok",
	"count": <int count>,
	"notifies":[
		{
	 		"notify": <notify>,
			...
		}
	]
}
  • count： int类型，获取到的通知数量
  • notify： notify类型，定义见这里

失败

API_UNAUTHORIZED

 获取通知详情

通知详情url：/notifies/<notify_id>?user_id=<user_id>

  • notify_id：int类型，通知的id，必须
  • user_id： int类型，访问该通知的用户id，必须

 获取七牛上传凭证

请求

GET /uptoken
Authorization: Basic Auth

成功

{
	"code": 2000,
	"desc": "ok",
	"uptoken": <string uptoken>
}

  • uptoken ： string类型，七牛上传凭证。该凭证对应的策略中指定了当上传成功后七牛服务器返回的响应内容，为：

     {
 	"url": <string url>
 }
    • url：string类型，资源的公网可访问地址

失败

API_UNAUTHORIZED

推送相关

推送目前接入个推，一律采用透传消息的形式，消息体为json格式，且一定包含ptype字段，具体的值在下面每个类型的推送消息中会有介绍。

 新的直播推送

ptype = 0

{
	ptype: 0,
	channel_id: <int channel_id>，
	owner_nickname: <string owner_nickname>，
	title: <string title>,
	content: <string content>
}
  • channel_id：int类型，新的直播id
  • owner_nickname：string类型，直播用户的昵称
  • title：string类型，通知的标题，仅在管理员推送时有该字段
  • content：string类型，通知的内容，仅在管理员推送时有该字段

 新的通知推送

ptype = 1

{
	ptype: 1,
	notify_id: <int notify_id>，
	title: <string title>,
	content: <string content>
}
  • notify_id：int类型，新的通知id
  • title：string类型，通知的标题
  • content：string类型，通知的内容