ChannelAdminService

PATCH /v1/admin/channels/{id}

Changed on

Request

Path parameters

idstring required

Request body

apiKeystring
autoDisableJsonstring
baseUrlstring
costRatiostring

成本倍率 PATCH 三态:不传=不变;""=清空为未配置(落 NULL);非空 decimal=覆盖。 非法值返回 400,reason=CHANNEL_COST_RATIO_INVALID。

extraConfigJsonstring
forwardCancelSignalboolean

PATCH 三态:不传=不变;false=不转发;true=转发客户端取消信号。

hasApiKeyboolean

api_key:has_api_key=true 且 api_key 非空 → 旋转密钥;空字符串视为不变(避免误清空)。

headerOverrideJsonstring

覆盖三件套 PATCH 三态:

  • 不传 = 不改;
  • "" / "{}" = 清空该配置;
  • 非空 JSON = 覆盖。 param/header 均不允许 stream 键(写入前 biz 侧拒 400)。
headerStripJsonstring

header_strip PATCH 三态 (对齐 header_override_json 的 optional string 语义):

  • 不传 = 不改
  • "" / "[]" = 清空
  • '["X-Foo", "X-Bar"]' JSON 数组 = 覆盖 后端解析 JSON 到 []string; biz 校验 blocklist / 数量上限。
idstring
modelMappingJsonstring
namestring
paramOverrideJsonstring
passthroughBodyboolean
priorityinteger
regionstring
remarkstring
responsesWebsocketEnabledboolean

PATCH 三态:不传=不变;false=关闭;true=开启。

retryJsonstring
statusinteger
timeoutMsinteger

Response

OK

Changes

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status