Arkloop Developers

Subscriptions & Plans

Plans(套餐)

列出套餐

GET /v1/plans

响应

[
  {
    "id": "...",
    "name": "starter",
    "display_name": "入门版",
    "created_at": "2024-01-01T00:00:00Z",
    "entitlements": [
      {
        "id": "...",
        "key": "credits.monthly_grant",
        "value": "1000",
        "value_type": "integer"
      }
    ]
  }
]

获取套餐

GET /v1/plans/{id}

创建套餐

POST /v1/plans

需要 platform_admin 权限。

请求体

字段类型必填说明
namestring内部名称(唯一)
display_namestring显示名称
entitlementsarray初始权益列表

权益对象

字段类型说明
keystring权益键
valuestring权益值
value_typestringinteger/boolean/string

Subscriptions(订阅)

创建订阅

POST /v1/subscriptions

需要 platform_admin 权限。

请求体

字段类型必填
org_idstring
plan_idstring
current_period_startstring
current_period_endstring

响应

{
  "id": "...",
  "org_id": "...",
  "plan_id": "...",
  "status": "active",
  "current_period_start": "2024-01-01T00:00:00Z",
  "current_period_end": "2024-02-01T00:00:00Z",
  "cancelled_at": null,
  "created_at": "2024-01-01T00:00:00Z"
}

列出订阅

GET /v1/subscriptions

获取订阅

GET /v1/subscriptions/{id}

取消订阅

DELETE /v1/subscriptions/{id}

On this page