Anymock

异步回调

异步回调:模拟支付这种「过会儿再通知」

支付、下单、审核这类接口都不是一次调用就结束的:你请求之后先拿到一句「处理中」, 真正的结果由服务端第二次主动送过来,送到你留的那个地址上。 这件事光靠「延迟返回」演不出来:延迟只是把同一个响应晚点给回去, 回调是另一次请求,方向都反过来了。

在响应编辑区的折叠项里打开「延迟后回调(模拟支付这类异步通知)」,填三样就行:

填什么怎么填
回调地址想谁调用就通知谁,写 {{request.body.notify_url}}(请求体里带 notify_url 字段)或 {{request.query.notify_url}}(地址栏带 ?notify_url=),各家支付网关就是这么做的;只想联调自己固定的接收端,直接把完整地址写死
多久之后毫秒,1000 = 1 秒。还能再填一个「最慢多久」,这样每次在两个时间之间随机,比固定值更像真实网络
回调内容和响应内容一样支持 {{...}}:{{request.body.order_id}} 把下单时的订单号原样带回去,{{faker.string.uuid}} 每次生成一个新的流水号
# 建一条「支付下单」:响应写「处理中」,3 秒后回调到 notify_url
# 调一次(这里拿 HTTP Echo 当接收端:它会把收到的内容原样返回,并记进调用日志)
curl -X POST http://127.0.0.1:8080/m/你的路径 \
  -H 'Content-Type: application/json' \
  -d '{"order_id":"NO-1001","amount":88,"notify_url":"http://127.0.0.1:8080/echo/你的专属目录/pay"}'

# 立刻就拿到(不用等那 3 秒)
{"code":0,"trade_status":"WAIT_PAY","out_trade_no":"NO-1001"}

# 3 秒后,你留的那个地址会收到一条
POST /echo/你的专属目录/pay
{"out_trade_no":"NO-1001","trade_no":"...","trade_status":"PAID","total_amount":88}

调用日志里这两段是挨着的两行:上面那条是别人来调用你(类型「接口调用」), 下面那条是 anymock 主动发出去的(类型「异步回调」),点开「详情」能看到发出去的正文、 对方回的状态与耗时。发不出去也会记一条,状态显示「未发出」, 原因写成中文(连不上 / 超时 / 域名解析失败),不会甩一串英文异常给你。

  • 回调排在内存里:服务重启,还没发出去的就没了。它只负责把流程演示出来,不负责送达; 真靠回调过日子的业务本来就该有自己的重试体系;
  • 回调地址默认不能指向内网(防 SSRF)。本机联调要写 http://127.0.0.1:端口/… 时, 让服务端开 callback.allow-internal = true;
  • 回调挂在每条响应上,于是能拼进条件响应与响应序列: 「前三次回调成功、第四次回调失败」「金额大于 1000 走人工审核,30 秒后才回调」 都是配出来的,不用写代码。

想先看效果再自己配:控制台「我的 API → 从模板创建」里有现成的 「支付下单(异步回调)」,套上之后带 notify_url 调一次,3 秒后就能收到通知。

用 AI 客户端(MCP) 也能配:create_rule 的 callbackUrl / callbackMethod / callbackDelayMs / callbackBody / callbackHeaders 就是上面这一块。要注意 call_rule 只看得到立刻回来 的那一段(排上队时会多给一个 callbackScheduled), 发出去的那一次得用 recent_logs 加 kind=callback 去查。

渲染种子:让每次返回都一样

响应里写 {{faker.person.fullName}} 这类模板时,每次调用都是新的一批假数据,看效果方便,写断言麻烦:只能检查"它是个字符串",不敢比具体值。

在规则的「渲染种子」里填一个数字之后,这条规则里的 faker 与 Mock.js 每次都从同一起点取随机数,于是同一个 seed 永远渲染出同样的字节:

# 规则上配了 seed = 42
$ curl http://127.0.0.1:8080/m/abc
{"id":"ba419d35-…","name":"王秀英","city":"西安","amount":8418}
$ curl http://127.0.0.1:8080/m/abc      # 再调一次,一模一样
{"id":"ba419d35-…","name":"王秀英","city":"西安","amount":8418}
  • 留空或填 0 = 每次随机(默认)。换个数字就换一份稳定的数据。
  • 只管数据,不管调度。故障率、序列的随机抽取 / 加权抽取仍然是真随机——否则配了种子的规则会变成"要么一次都不失败、要么每次都失败",故障率就没意义了。
  • faker 的 UUID 也跟着种子走(不会因为它是"真随机 UUID"就漏掉)。