---
title: "Register endpoint; secret returned once / 注册端点并一次性返回密钥"
method: POST
path: "/callbacks"
---

# Register endpoint; secret returned once / 注册端点并一次性返回密钥

`POST /callbacks`

## Request

- Base URL: `https://clipmivoai.com/api/open/v1`
- URL: `https://clipmivoai.com/api/open/v1/callbacks`
- Auth: HTTP bearer

Requires operator-enabled callbacks and an allowed public HTTPS host. Maximum five active endpoints per owner. / 需要运营端启用回调并允许目标HTTPS主机，每个账户最多五个有效端点。

## Request body

- object
  - `url` string, uri, required

## Response `201`

Success / 成功

- object
  - `success` unknown, required
  - `request_id` string, required
  - `data` object, required
    - `id` string, required
    - `url` string, required
    - `secret` string, required
    - `verified` unknown, required

## Other responses

- `400`: Request rejected / 请求被拒绝
- `401`: Request rejected / 请求被拒绝
- `403`: Request rejected / 请求被拒绝
- `404`: Request rejected / 请求被拒绝
- `409`: Request rejected / 请求被拒绝
- `413`: Request rejected / 请求被拒绝
- `422`: Request rejected / 请求被拒绝
- `429`: Request rejected / 请求被拒绝
- `503`: Request rejected / 请求被拒绝

---

[API](https://skmtc.dev/clipmivoai/apis/clipmivoai-api.md) · [All operations](https://skmtc.dev/clipmivoai/apis/clipmivoai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipmivoai/apis/clipmivoai-api/revisions/6e6d5f5a84a7?raw)