1. 部落成员列表
1.1. 协议
- REST-URL:
/tribe/member/list
- REST-HTTP-Method:
POST
- COUTENT-TYPE:
application/x-www-form-urlencoded; charset=UTF-8
1.2. 请求参数
公共参数： 点击查看
业务参数:
| 字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
| tribeId |
String |
10 |
NO |
部落id，不填写部落ID返回学校所有部落成员 |
| updateTime |
String |
64 |
NO |
更新标识(非时间格式，用普通字符串格式字段来存储)，2021-08-12 12:05:03.291376_12349，增量查询使用，第一次查询不需要填写，接口返回的数据是按照updateTime升序排列，第二次之后依次使用上一次查询时接口返回数据的最后一条数据的updateTime字段，作为下一次调用接口的参数传回，依次循环即可获取所有的数据。 |
1.3. 响应参数
| 字段名称 |
类型 |
字段说明 |
| data |
String |
如果有数据返回内容 |
| success |
Boolean |
请求处理结果状态 |
| msg |
String |
接口调用结果提示信息 |
| code |
String |
状态码 |
data 数据:
| 字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
| identificationCode |
String |
32 |
YES |
唯一识别码，可用接口调用方避免重复。根据该字段判断本地是否已经存在该条记录，如存在做更新操作。 |
| tribeId |
int |
-- |
YES |
部落ID |
| tribeName |
String |
-- |
YES |
部落名称 |
| studentId |
int |
-- |
YES |
学生id |
| studentName |
String |
-- |
YES |
学生姓名 |
| studentNo |
String |
-- |
YES |
学号 |
| schoolName |
String |
-- |
YES |
学校名称 |
| collegeName |
String |
-- |
YES |
院系名称 |
| joinTribeTime |
String |
-- |
YES |
加入部落时间 |
| exitTribeTime |
String |
-- |
YES |
退出部落时间 |
| isDelete |
Boolean |
-- |
YES |
是否删除 |
| role |
String |
-- |
YES |
角色（部落成员/部落管理员/部落负责人） |
| nameCard |
String |
-- |
YES |
名片(多个名片英文逗号分割) |
| updateTime |
String |
32 |
YES |
2021-08-12 12:05:03.291376_12349,更新标识(非时间格式，用普通字符串格式字段来存储)，作为批量获取数据接口的增量查询使用 |
1.4. http请求参数示例
https://openapi.5idream.net/tribe/member/list?openId=214055b2cfa544b3&token=01C933C844B9CA2C4CC
&sign=98521174E313B24617A2&signType=MD5&info_content={"tribeId":"1","updateTime":""}
1.5. 响应参数示例
{
"code": "100",
"data": "swadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffwe",
"msg": "操作成功",
"success": true
}
1.6. data解密后格式
[{
"identificationCode": "唯一识别编号",
"collegeName": "梦想剧场",
"joinTribeTime": "2019-06-04 15:48",
"exitTribeTime": "2023-11-20 15:08",
"nameCard": "",
"role": "部落负责人",
"schoolName": "到梦大学",
"isDelete": false,
"studentId": 244205,
"studentName": "麻豆",
"studentNo": "20001",
"tribeId": 95922,
"tribeName": "篮球吧",
"updateTime": "2019-12-05 11:36:42.478901"
}]
1.7. 异常响应说明
| code编码 |
字段说明 |
可采取行动 |
| 9007 |
部落不存在 |
请输入正确的部落id |
| 9008 |
部落已解散,不能查看成员列表 |
请查询未解散部落成员信息 |