Darkroom API v2

Darkroom API v2 使用 OAuth 2.0 client_credentials 认证、标准 HTTP 状态码和基于订单编号的自然幂等。本规格定义了服务端实现、契约测试与公开开发文档共同遵循的接口契约。

认证：使用长期的 client_id 和 client_secret 向 /oauth/token 获取有效期 1 小时的 Bearer token。业务请求仅需发送 Authorization: Bearer <token>。 client_credentials 流程不返回 refresh_token；客户端可使用现有凭据获取新的访问令牌。该行为符合 RFC 6749 §4.4.3。

环境：建议先在沙盒 https://sandbox-api.darkroom.net/v2 完成集成验证，再切换生产环境。沙盒与生产环境完全隔离，沙盒不会发送真实通知。两者的凭据前缀分别为 dr_test_ 和 dr_live_，不同环境的凭据不能混用。