创建会议

POST

/internal/v1/meetings/

Required application Scope: meeting:write. Only the consumer or creating management application can access the meeting. Creating for another consumer also requires meeting:publish. Public expert cards use the same platform and publication gate.

project_id 必须是已存在的有效项目，接口不会自动创建项目。省略 consumer_application_id 表示当前应用自有会议；指定其他应用需额外 meeting:publish，目标应用需启用、未过期且有 conference:read。新会议直接为 published，结束时间须晚于开始时间。创建后不能通过状态更新转移应用归属；join_url 不出现在公开 Meeting DTO。

鉴权：每次请求使用独立 Nonce 和当前秒级时间戳，签名必须基于实际发送的请求体字节；完整协议见项目内《NDB 第三方服务端接入指南》。本接口示例数据均为虚构值。

请求参数

Authorization

API Key

在 header 添加参数

X-NDB-Access-Key

示例：

X-NDB-Access-Key: ********************

Header 参数

Body 参数

application/json

必填

示例

{
    "project_id": 3001,
    "title": "新能源汽车产业交流会",
    "type": "ONLINE",
    "tags": [
        "新能源"
    ],
    "background": "交流行业趋势",
    "description": "线上专题交流",
    "outline": "市场趋势与技术路线",
    "background_image_url": "https://example.com/meeting-cover.png",
    "join_url": "https://example.com/join/demo",
    "starts_at": "2026-10-20T14:00:00+08:00",
    "ends_at": "2026-10-20T15:00:00+08:00",
    "client_charge_hours": "1.0000",
    "is_third_party": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://crm-api.mindsetech.com/internal/v1/meetings/' \
--header 'Idempotency-Key;' \
--header 'X-NDB-Timestamp;' \
--header 'X-NDB-Nonce;' \
--header 'X-NDB-Content-SHA256;' \
--header 'X-NDB-Signature;' \
--header 'X-NDB-Access-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "project_id": 3001,
    "title": "新能源汽车产业交流会",
    "type": "ONLINE",
    "tags": [
        "新能源"
    ],
    "background": "交流行业趋势",
    "description": "线上专题交流",
    "outline": "市场趋势与技术路线",
    "background_image_url": "https://example.com/meeting-cover.png",
    "join_url": "https://example.com/join/demo",
    "starts_at": "2026-10-20T14:00:00+08:00",
    "ends_at": "2026-10-20T15:00:00+08:00",
    "client_charge_hours": "1.0000",
    "is_third_party": false
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "data": {
        "id": 1001,
        "consumer_application_id": 21,
        "managed_by_application_id": 21,
        "updated_by_id": null,
        "project_id": 3001,
        "title": "新能源汽车产业交流会",
        "type": "ONLINE",
        "tags": [
            "新能源"
        ],
        "industry_id": null,
        "industry_name": null,
        "background": "交流行业趋势",
        "description": "线上专题交流",
        "outline": "市场趋势与技术路线",
        "background_image_url": "https://example.com/meeting-cover.png",
        "experts": [],
        "starts_at": "2026-10-20T14:00:00+08:00",
        "ends_at": "2026-10-20T15:00:00+08:00",
        "client_charge_hours": "1.0000",
        "customer_charge_hours": 1,
        "is_third_party": false,
        "registration_open": true,
        "status": "published",
        "created_at": "2026-10-15T10:00:00+08:00",
        "updated_at": "2026-10-15T10:00:00+08:00"
    },
    "code": 200,
    "message": "操作成功"
}

🟠400

🟠401

🟠403

🟠404

🟠409

修改于 2026-10-14 17:33:15

会议列表

会议详情