POST
/v1/sandbox/reset
沙盒 · 清掉投递记录与调用日志
Scope
merchant:read
商户自身
需 x-idempotency-key
清两张表:merchant_webhook_deliveries(Webhook 投递记录)与
merchant_api_logs(API 调用日志),并把四家上游的行为注入删掉。
账本分录、订单、会员一条都不删。 账本是追加写的,删它等于教你
一个在生产上做不了的动作 —— 而沙盒的全部意义是「与生产一样」。
删单留凭证还会造出一个「有账没单」的状态,那在生产上是一次事故的形状。
所以重置之后余额不会归零:那是对的。要花掉就下单,要更多钱就用水龙头。
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
x-idempotency-key |
string | 必填 | UUID v4 |
响应
200已清理(
cleared 逐表给删掉的行数){
"ok": true,
"cleared": {
"merchant_webhook_deliveries": 412,
"merchant_api_logs": 5031
},
"note": "账本分录与订单不删 —— 账本是追加写的,删它等于教你一个在生产上做不了的动作。"
}404不在沙盒环境
调用样例
curl -X POST 'https://api.zise.com/v1/sandbox/reset' \
-H 'authorization: Bearer $TOKEN' \
-H 'x-zise-merchant: $MERCHANT_ID' \
-H 'x-idempotency-key: $(uuidgen)'
const res = await fetch(
"https://api.zise.com/v1/sandbox/reset",
{
method: "POST",
headers: {
"authorization": "Bearer $TOKEN",
"x-zise-merchant": "MERCHANT_ID",
"x-idempotency-key": "crypto.randomUUID()"
},
},
);
// 金额一律按字符串读,不要 JSON.parse 成 number
const data = await res.json();
import requests
res = requests.post(
"https://api.zise.com/v1/sandbox/reset",
headers={
"authorization": "Bearer $TOKEN",
"x-zise-merchant": "$MERCHANT_ID",
"x-idempotency-key": "$(uuidgen)"
},
)
# 金额用 Decimal(str(...)),不要 float
data = res.json()