API 参考Webhook

生成新签名密钥；旧密钥在 24 小时内仍用于签名

POSThttps://api.astrum.shop/v1/webhook/rotate-secret

权限范围 webhooks:manage, orders:read, wallet:read

未收到响应时直接重试即可：旧密钥仍会继续签名。

签名密钥只显示一次，请将其保存到服务器的密钥存储中。

响应

字段说明

secret

string

新的签名密钥，只显示一次。

previous_secret_expires_at

string | null

旧签名密钥继续为事件签名的截止时间。

所有接口通用的错误，详见「错误码」章节：

10001 invalid_key10002 key_scope_missing10003 ip_not_allowed10004 browser_not_allowed10005 account_suspended20001 too_many_requests90002 api_disabled90001 internal_error

import os, httpx response = httpx.post( "https://api.astrum.shop/v1/webhook/rotate-secret", headers={"Authorization": f"Bearer {os.environ['ASTRUM_KEY']}"}, timeout=30, ) data = response.json()

const response = await fetch("https://api.astrum.shop/v1/webhook/rotate-secret", { method: "POST", headers: { Authorization: `Bearer ${process.env.ASTRUM_KEY}`, }, }); const data = await response.json();