帮助文档
  1. 开发者手册
  2. 通讯录管理
帮助文档
  • 产品介绍
    • 产品价值及介绍
    • 产品应用场景
    • 产品重点特性
    • 系统架构
    • 部署架构
    • 资质背书
  • 管理员手册
    • 入门必读
    • 第三方服务同步配置
      • 钉钉
      • 飞书
      • 企业微信
      • 腾讯会议
      • ExchangeWebService国际版
      • Outlook国际版
      • Outlook国内版
  • 功能详解
    • 我的企业
      • 概要
      • 首页
      • 通讯录
      • 空间资源
      • 权限管理
      • 安全
      • 第三方对接
      • 操作日志
      • 增值服务
    • 设备资产
      • 概要
      • 设备关联
      • 分配空间
      • 设备标签
      • 设备巡检
      • 解绑设备
    • 设备管控
      • 设备监控
      • 巡检报告
      • 设备控制
      • 设备详情
      • 定时任务
      • 告警策略
      • 远程桌面
      • 应用管理
      • 文件推送
      • 壁纸推送
      • 消息推送
      • 命令行推送
      • 弹窗拦截
      • 设备看板
      • 权限管理
      • 操作记录
    • 会议管理
      • 会议室管理
      • 会议管理
      • 预约配置
      • 通知配置
      • 门牌配置
      • 门禁配置
      • 会议数据
      • 权限管理
      • 操作记录
    • 内容宣发
      • 概要
      • 内容制作
      • 信息发布
      • 设备主页
      • 设备屏保
      • 展厅播控
      • 智能迎宾
      • 操作记录
      • 组件
    • 其他功能
      • 消息通知
      • 个人中心
      • 专属服务
  • 方案产品
    • 会议预约小程序
    • 会议预约web端
    • 腾讯会议对接
    • 设备助手
    • 门牌&门禁
    • 展厅控制屏
    • 会控屏
  • 开发者手册
    • API调用指南(必看)
      • 调用流程概述
      • 公共参数
      • 最佳实践 - 三方系统约会显示在在门牌上
      • 最佳实践 - 代码实现参考(JAVA)
    • 接口授权
      • 生成客户端令牌
    • 单点登录
      • 手机号免密登录授权
    • 通讯录管理
      • 分页查询成员
        GET
      • 查询成员
        GET
      • 根据外部id查询成员
        GET
      • 创建成员
        POST
      • 更新成员
        PUT
      • 删除成员
        DELETE
      • 分页查询团队列表
        GET
      • 查询团队
        GET
      • 根据外部ID查询团队
        GET
      • 创建团队
        POST
      • 更新团队
        PUT
      • 删除团队
        DELETE
      • 根据手机号查询成员id
        POST
      • 根据邮箱查询成员id
        POST
    • 空间管理
      • 更新空间
      • 分页查询空间
      • 创建空间(楼层)
      • 创建空间
      • 查询空间分类
      • 通过空间ID获取空间
      • 删除空间
      • 查询空间日程
    • 设备管理
      • 设备控制
        • 设备指令下发
      • 设备信息
        • 获取设备详情
        • 获取设备属性
        • 修改设备属性
        • 获取设备品类支持的指令集
    • 事件回调
      • 注册回调
      • 会议事件回调
      • 参会人事件回调
      • 用户签到事件回调
      • 失败记录
      • 清除失败记录
      • 查询失败记录
      • 取消回调
      • 注册回调
    • 日程管理
      • 日程
        • 创建会议日程
        • 更新会议日程
        • 取消会议日程
        • 结束会议日程
        • 会议日程签到
        • 查询会议日程详情
        • 创建周期日程
        • 取消周期日程
        • 查询周期日程
        • 更新周期日程
      • 参会人
        • 查询成员日程列表
        • 确认参加会议日程
        • 查询参会人闲忙
        • 批量删除参会人
        • 批量添加参会人
        • 拒绝参加会议日程
        • 会议日程请假
      • 签到
        • 查询会议日程的人员签到记录
      • 会议室
        • 查询会议室闲忙
        • 释放会议室
        • 预定会议室
  • 更新日志
    • 1.7.1 版本
    • 1.8.1版本
    • 1.8.6版本
  1. 开发者手册
  2. 通讯录管理

创建成员

POST
https://api.maxhub.com/maxhub-blu/api/open/v5/member

请求参数

Header 参数
X-Isp-Code
string 
必需
组织码,获取路径:领效星云管理页面-> 我的企业 -> 企业ID
示例值:
{{sign_orgCode}}
Authorization
string 
客户端令牌
必需
示例值:
Bearer {{sign_client_token}}
X-Isp-TraceId
string 
必需
请求ID, 随机生成的32位uuid
示例值:
{{uuid}}
X-Auth-Sign
string 
必需
签名,规则参考参数验签生成规则
示例值:
{{sign}}
X-Auth-Timestamp
string 
必需
请求发送的毫秒时间戳
示例值:
{{timestamp}}
Body 参数application/json
memberNo
string 
成员编号
可选
teamId
number 
团队ID
可选
jobTitle
string 
职位
可选
mobile
number 
手机不能为空
必需
memberName
string 
成员名字
可选
externalId
string 
外部ID
可选
cardNo
string 
工卡ID
可选
email
string 
邮箱
可选
示例
{
  "memberNo": "121",
  "teamId": 50,
  "jobTitle": "经理",
  "mobile": "1562223322",
  "memberName": "张三",
  "externalId": "test123",
  "cardNo": "95271",
  "email": "test@qq.com"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.maxhub.com/maxhub-blu/api/open/v5/member' \
--header 'X-Isp-Code: {{sign_orgCode}}' \
--header 'Authorization: Bearer {{sign_client_token}}' \
--header 'X-Isp-TraceId: {{uuid}}' \
--header 'X-Auth-Sign: {{sign}}' \
--header 'X-Auth-Timestamp: {{timestamp}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "memberNo": "121",
    "teamId": 50,
    "jobTitle": "经理",
    "mobile": "1562223322",
    "memberName": "张三",
    "externalId": "test123",
    "cardNo": "95271",
    "email": "test@qq.com"
}'

返回响应

🟢200成功
application/json
Body
code
number 
返回码
必需
data
object 
返回数据
必需
memberNo
string 
组织描述
必需
jobTitle
string 
职位
必需
teamId
string 
团队 ID
必需
mobile
string 
手机
必需
externalId
string 
成员编号
必需
memberName
string 
成员名字
必需
id
string 
主键
必需
userId
string 
用户 ID
必需
cardNo
string 
工卡ID
必需
email
string 
邮箱
必需
message
string 
返回信息
必需
示例
{
    "code": 200,
    "message": "OK",
    "data": {
        "id": "1864590792589639680",
        "teamId": "0",
        "userId": "efea55c4-12b0-4f01-8958-2bb2008018de",
        "mobile": "15622222222",
        "email": "",
        "memberNo": “12312",
        "memberName": "janmee",
        "cardNo": “112",
        "jobTitle": “职位",
        "externalId": "externalId123"
    },
    "success": true,
    "failure": false
}
修改于 2024-12-25 09:32:22
上一页
根据外部id查询成员
下一页
更新成员