Flashcat API

团队Upsert

POST

/team/upsert

最后修改时间：2025-03-31 11:20:18

请求参数

Authorization

在 query 添加参数

app_key

示例：

app_key: ********************

Header 参数

Content-MD5

string

必需

示例值:

application/json

Body 参数application/json

team_id

integer

团队ID

可选

team_name

string

团队名称

必需

团队名称要求账户下唯一

reset_if_name_exist

boolean

是否按名称更新

可选

如果没有传入团队ID，但团队名称已经存在，此值为true时，将更新同名团队，否则拒绝更新，提示存在同名团队

description

string

团队描述

必需

ref_id

string

关联ID

可选

person_ids

array[integer]

成员ID列表

可选

邮件、手机和ID列表至少有一个，同时存在多个，系统会进行合并

emails

array[string]

成员邮件列表

可选

邮件、手机和ID列表至少有一个，同时存在多个，系统会进行合并。当邮件同时被主体和成员使用，将同时邀请二人加入团队

phones

array[string]

成员手机列表

可选

邮件、手机和ID列表至少有一个，同时存在多个，系统会进行合并。当邮件同时被主体和成员使用，将同时邀请二人加入团队

示例

{
  "team_id": 0,
  "team_name": "string",
  "reset_if_name_exist": true,
  "description": "string",
  "ref_id": "string",
  "person_ids": [
    0
  ],
  "emails": [
    "string"
  ],
  "phones": [
    "string"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.flashcat.cloud/team/upsert?app_key' \
--header 'Content-MD5: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "team_id": 0,
    "team_name": "string",
    "reset_if_name_exist": true,
    "description": "string",
    "ref_id": "string",
    "person_ids": [
        0
    ],
    "emails": [
        "string"
    ],
    "phones": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

Body

error

object (DutyError)

可选

code

enum<string>

错误码

必需

枚举值:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

错误描述

必需

data

object

可选

team_id

integer

可选

示例

{
  "error": {
    "code": "InvalidParameter",
    "message": "string"
  },
  "data": {
    "team_id": 0
  }
}

修改于 2025-03-31 11:20:18

团队删除

创建值班表