POST /v1/apikeys — 创建 PIN API 密钥

curl -X POST https://ariapin.example.com:8001/v1/apikeys \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{"name":"production"}'

{
  "code": 0,
  "data": {
    "id": "key_xyz",
    "name": "production",
    "key": "pin_live_abc123..."
  },
  "message": ""
}

curl -X POST https://ariapin.example.com:8001/v1/apikeys \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{"name":"production"}'

{
  "code": 0,
  "data": {
    "id": "key_xyz",
    "name": "production",
    "key": "pin_live_abc123..."
  },
  "message": ""
}

为 PIN API 生成一个新的用户作用域 API 密钥。可以给密钥起个名字区分用途。完整密钥值只在这个响应里返回一次，之后无法再次获取。

接口

POST /v1/apikeys 认证：Bearer API 密钥

请求体

string

default:"default"

新密钥的名称。

响应

string

密钥 id。

string

密钥的名称。

string

完整的明文 API 密钥。立即保存，之后不再显示。

string

密钥创建的 ISO 8601 时间戳。

示例

curl -X POST http://localhost:8001/v1/apikeys \
  -H "Authorization: Bearer $ARIA_PIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"ci-deploy"}'

{
  "id": "key_9xYz2AbC3dE4",
  "name": "ci-deploy",
  "key": "ak_live_51HbN9xL5wR8fGqJ3...",
  "created_at": "2025-02-08T11:45:00Z"
}

生成一个新的 API 密钥用于编程访问。提供一个名称用于识别该密钥。完整密钥值只返回一次，之后无法再次获取。

接口

POST /v1/apikeys

认证

需要有效的 Authorization: Bearer <jwt-or-api-key> 头。

请求体

string

required

新 API 密钥的名称。

响应

string

新 API 密钥的 id。

string

请求中提供的名称。

string

完整 API 密钥值，只显示一次，请立即保存。

curl -X POST https://ariapin.example.com:8001/v1/apikeys \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{"name":"production"}'

{
  "code": 0,
  "data": {
    "id": "key_xyz",
    "name": "production",
    "key": "pin_live_abc123..."
  },
  "message": ""
}

PIN API

ROUTER API

AGENT API

MEMO API

POST /v1/apikeys — 创建 PIN API 密钥

接口

请求体

响应

示例

接口

认证

请求体

响应

​接口

​请求体

​响应

​示例

​接口

​认证

​请求体

​响应

接口

请求体

响应

示例

接口

认证

请求体

响应