Skip to main content
POST
查询技能列表

限制说明

使用说明

  • 列表行中省略 content 字段;如需正文请单独查询某个技能。
  • scope 用于选择 all(默认)、仅 account、或仅 team,会覆盖 include_account;非管理员请求特定 team_ids 时会被静默过滤为其所属的团队。
  • update_available 每次调用会与市场目录比对一次;若目录加载失败,仅会隐藏该徽标,不会导致请求失败。

授权

app_key
string
query
必填

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

请求体

application/json

技能列表的分页、搜索与团队过滤条件。

p
integer
默认值:1

页码,从 1 开始。

limit
integer
默认值:20

每页数量。

scope
enum<string>

将结果限制为 all(默认)、仅 account(team_id=0)、或仅 team(排除账户级记录);设置后会覆盖 include_account

可用选项:
all,
account,
team
query
string

跨技能名称、描述、英文描述、技能 ID、市场来源模板名称与作者的全文搜索。

Maximum string length: 128
team_ids
integer<int64>[]

按团队 ID 过滤;为空则使用调用者可见范围。

include_account
boolean | null

是否包含账户级(team_id=0)记录,默认 true。当 scopeaccountteam 时该字段会被忽略。

响应

Success

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
必填

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
object

分页的技能列表。