2026法律服务博览会数据接收

公共规则

请求方式为 HTTP POST，Body 使用 raw JSON。
请求头必须包含 X-API-Key，值为服务配置中的 API Key。
Content-Type 使用 application/json。
name、company 必传；title、id_type、IDCardNO 可选。
barcode 必须是 8 位数字。新增时可不传，不传由后端生成并返回；更新时必须传。
source_id 建议传对方系统稳定唯一 ID；服务使用 source_id + payload_hash 防止重复插入。
新增数据写入 regs_attendees_11346，默认 ticket 为 观众。

新增人员

POST/api/v1/attendees/receive

{
  "source_id": "miniapp-user-001",
  "name": "张三",
  "company": "测试公司",
  "title": "经理",
  "id_type": "idcard",
  "IDCardNO": "330100199001011234"
}

不传 barcode 时，成功响应会返回后端生成的 8 位数字条码。

{
  "code": "OK",
  "message": "received",
  "data": {
    "id": 1,
    "barcode": "12345678"
  },
  "request_id": "..."
}

同一个 source_id 与同一份 payload 重复提交时，不再新增行，返回原记录。

{
  "code": "OK",
  "message": "received",
  "data": {
    "id": 1,
    "barcode": "12345678",
    "duplicate": true
  },
  "request_id": "..."
}

指定条码新增

POST/api/v1/attendees/receive

{
  "source_id": "partner-row-10001",
  "barcode": "12345678",
  "name": "李四",
  "company": "示例公司",
  "title": "总监",
  "id_type": "passport",
  "IDCardNO": "P1234567"
}

更新人员

POST/api/v1/attendees/update

{
  "barcode": "12345678",
  "name": "张三修改后",
  "company": "测试公司修改后",
  "title": "总监",
  "id_type": "idcard",
  "IDCardNO": "330100199001011234"
}

更新接口使用 barcode 查找已有记录，不支持修改 barcode 本身。

常见错误码

INVALID_API_KEY: 请求头 API Key 不正确。
INVALID_JSON: Body 不是合法 JSON。
VALIDATION_ERROR: 必填字段缺失或 barcode 不是 8 位数字。
DUPLICATE_BARCODE: 指定 barcode 已存在，或自动生成多次碰撞。
DUPLICATE_REQUEST: source_id 与 payload 指纹已经存在，但未能返回原记录。
ATTENDEE_NOT_FOUND: 更新时找不到对应 barcode。
DATABASE_ERROR: 数据库读写失败或超时。

2026法律服务博览会

最后一条