Social Tables API带颜色标签创建/更新报错求助及示例需求

错误原因 #

你遇到的TypeError: tag.trim is not a function错误，是因为后端API期望tags字段接收字符串数组，但你传入了对象数组。后端会对每个标签元素调用字符串的trim()方法处理空格，对象没有这个方法，因此抛出错误并返回500状态码。

正确实现步骤 #

1. 先通过Tags API创建带颜色的标签 #

首先需要单独创建带颜色属性的标签实体，请求示例如下：

POST /api/v1/events/{你的活动ID}/tags
Content-Type: application/json

{
  "name": "Male",
  "color": "#4285F4", // 十六进制颜色值
  "description": "男性参会者" // 可选描述字段
}

成功创建后，API会返回包含标签ID的响应：

{
  "id": "tag_123abc",
  "name": "Male",
  "color": "#4285F4",
  "event_id": "event_456def",
  "created_at": "2024-05-20T14:30:00Z"
}

2. 创建/更新访客时关联已创建的标签 #

创建访客时，直接在tags字段传入标签的名称字符串或ID字符串数组即可，系统会自动关联你之前创建的带颜色标签：

方式一：使用标签名称

POST /api/v1/events/{你的活动ID}/guests
Content-Type: application/json

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "tags": ["Male", "Advisor"]
}

方式二：使用标签ID

POST /api/v1/events/{你的活动ID}/guests
Content-Type: application/json

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "tags": ["tag_123abc", "tag_789ghi"]
}

3. 编辑已存在的标签 #

如果需要修改标签的颜色或名称，使用PUT请求调用标签详情端点：

PUT /api/v1/events/{你的活动ID}/tags/{标签ID}
Content-Type: application/json

{
  "name": "Male Attendee",
  "color": "#EA4335" // 修改为新的颜色值
}

关键注意事项 #

• 不要直接在访客的tags字段传入对象数组，API不支持这种内嵌创建方式，必须先创建标签实体再关联。
• 确保标签的名称或ID与已创建的标签完全匹配（注意大小写，后端可能区分）。

内容的提问来源于stack exchange，提问作者user2926176