| 方法 | 路径 | 摘要 | 认证 |
|---|---|---|---|
| GET | /v1/package-commerce/catalog | List package products purchasable by the authenticated tenant user | 登录会话 |
| GET | /v1/package-commerce/orders | List the authenticated tenant user's package orders | 登录会话 |
| GET | /v1/package-commerce/orders/{order_id} | Get one visible package order | 登录会话 |
| GET | /v1/package-commerce/orders/{order_id}/events | List sanitized order state events in revision order | 登录会话 |
| POST | /v1/package-commerce/provider-callbacks/{provider} | Authenticate and apply one raw payment-provider callback | 无需认证 |
| POST | /v1/package-commerce/purchases | Purchase a package subscription for the authenticated tenant user | 登录会话 |
| GET | /v1/package-commerce/subscriptions | List effective sold-subscription projections owned by the current user | 登录会话 |
| POST | /v1/package-commerce/subscriptions/{subscription_id}/downgrade | Downgrade a package immediately or at the next cycle | 登录会话 |
| POST | /v1/package-commerce/subscriptions/{subscription_id}/renew | Renew an active package subscription | 登录会话 |
| POST | /v1/package-commerce/subscriptions/{subscription_id}/upgrade | Upgrade a package immediately or at the next cycle | 登录会话 |
| POST | /v1/package-commerce/traffic-purchases | Purchase a versioned traffic package snapshot | 登录会话 |
| GET | /v1/package-commerce/traffic-purchases/{order_id} | Get a sanitized traffic-purchase order and grant result | 登录会话 |
契约文件：api/openapi/v1/control.yaml api/control-package-commerce.openapi.yaml