开发者文档

修改素人档案

PATCH/api/orgs/:orgId/creators/:id

权限与前置条件

所有者、管理员或所在小组成员；归档和恢复仅管理员。

支持账号中心 API Key：Authorization: Bearer <ltak_…>。中心每次实时校验，仍执行当前用户的工作区角色和业务权限。Cookie 写入仍需允许来源的 Origin 和 X-Requested-With: suren360。不能同时携带 Cookie 与 API Key。所有路径参数须使用真实 ID。

请求参数

orgId · 路径参数 · 必填字符串

id · 路径参数 · 必填字符串

JSON 请求体

字段	类型	必填	约束
`name`	string	否	`{"minLength":1,"maxLength":80}`
`idNumber`	string	否	`{"maxLength":18}`
`phone`	string	否	`{"maxLength":32}`
`wechat`	string	否	`{"maxLength":120}`
`email`	string	否	`{"maxLength":254}`
`alipayQrCode`	string	否	`{"maxLength":700000}`
`rating`	string	否	`{"enum":["","S","A","B","C","D"]}`
`platform`	string	否	`{"maxLength":40}`
`account`	string	否	`{"maxLength":120}`
`notes`	string	否	`{"maxLength":2000}`
`archived`	boolean	否	`{}`

查看完整请求 JSON Schema

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "idNumber": {
      "type": "string",
      "maxLength": 18
    },
    "phone": {
      "type": "string",
      "maxLength": 32
    },
    "wechat": {
      "type": "string",
      "maxLength": 120
    },
    "email": {
      "type": "string",
      "maxLength": 254
    },
    "alipayQrCode": {
      "type": "string",
      "maxLength": 700000
    },
    "rating": {
      "type": "string",
      "enum": [
        "",
        "S",
        "A",
        "B",
        "C",
        "D"
      ]
    },
    "platform": {
      "type": "string",
      "maxLength": 40
    },
    "account": {
      "type": "string",
      "maxLength": 120
    },
    "notes": {
      "type": "string",
      "maxLength": 2000
    },
    "archived": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

调用示例

先在统一账号中心创建 Key，并授权素人种草 360 应用，将密钥安全设置为 LINGTU_API_KEY 环境变量。请替换部署地址与示例字段，不要将凭证粘贴到聊天或日志中。

cURL · 示例占位值需替换

curl --request PATCH \
  'https://YOUR_DEPLOYMENT_HOST/api/orgs/YOUR_orgId/creators/YOUR_id' \
  --header "Authorization: Bearer $LINGTU_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{}'

响应结构

成功返回 HTTP 200 的 JSON 对象。下方为响应结构定义，不是虚构的业务数据。

字段	类型	必填	约束
`creator`	object	是	`{"required":["reviewStatus","loginUserId","id","organizationId","name","platform","account","notes","archived","groupId","responsibleUserId","groupName","responsibleName","needsHandoff","canEdit","canAssign","createdById","createdAt","updatedAt"],"additionalProperties":false}`

查看完整响应 JSON Schema

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "creator": {
      "type": "object",
      "properties": {
        "idNumber": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "wechat": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "alipayQrCode": {
          "type": "string"
        },
        "rating": {
          "type": "string"
        },
        "reviewStatus": {
          "type": "string"
        },
        "loginUserId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "id": {
          "type": "string"
        },
        "organizationId": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "platform": {
          "type": "string"
        },
        "account": {
          "type": "string"
        },
        "notes": {
          "type": "string"
        },
        "archived": {
          "type": "boolean"
        },
        "groupId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "responsibleUserId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "groupName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "responsibleName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "needsHandoff": {
          "type": "boolean"
        },
        "canEdit": {
          "type": "boolean"
        },
        "canAssign": {
          "type": "boolean"
        },
        "createdById": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        }
      },
      "required": [
        "reviewStatus",
        "loginUserId",
        "id",
        "organizationId",
        "name",
        "platform",
        "account",
        "notes",
        "archived",
        "groupId",
        "responsibleUserId",
        "groupName",
        "responsibleName",
        "needsHandoff",
        "canEdit",
        "canAssign",
        "createdById",
        "createdAt",
        "updatedAt"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "creator"
  ],
  "additionalProperties": false
}

查看错误码与重试规则