
本文讲解如何在构造 json 字符串时确保数值型字段(如时间戳)以原生整数形式而非字符串形式传输,避免因类型不匹配导致 api 调用失败。
本文讲解如何在构造 json 字符串时确保数值型字段(如时间戳)以原生整数形式而非字符串形式传输,避免因类型不匹配导致 api 调用失败。
在 Python 中向 REST API 发送 JSON 数据时,一个常见误区是将数字值用双引号包裹,使其成为 JSON 字符串(如 "1715234567"),而目标接口实际期望的是无引号的原始数字(如 1715234567)。你当前的 payload 是通过字符串拼接构建的,其中关键字段:
"sourceTimestamp":"'+ str(int(currentTime.timestamp())) +'"
虽然 str(int(...)) 生成了纯数字字符串(如 "1715234567"),但JSON 中被双引号包围的内容始终被解析为字符串类型——这正是 API 拒绝请求的根本原因。
✅ 正确做法是:移除该字段两侧的双引号,让整数直接嵌入 JSON 结构中:
Payload='[{"Code": "'+someCode+'","version": "v1","itemNumber": 1,"referenceId": "'+referenceId+'","alertBody": {"customerId": "'+customerId+'"},"Context":{"Id":"'+str(payload['body']['State']['Id'])+'","Name":"Payment","Expiration":0,"Action":"","sourceTimestamp":'+ str(int(currentTime.timestamp())) +',"sourceApp":"someApp"}}]'
注意变化:
❌ 原写法:"sourceTimestamp":"1715234567" → JSON 字符串
✅ 修正后:"sourceTimestamp":1715234567 → JSON 数字(整数)
⚠️ 重要注意事项:
- 字符串拼接构造 JSON 极易出错(如引号逃逸、类型混淆、空值崩溃),强烈建议改用 json.dumps() 自动序列化。例如:
import json payload_dict = [{ "Code": someCode, "version": "v1", "itemNumber": 1, "referenceId": referenceId, "alertBody": {"customerId": customerId}, "Context": { "Id": str(payload['body']['State']['Id']), "Name": "Payment", "Expiration": 0, "Action": "", "sourceTimestamp": int(currentTime.timestamp()), # ← 天然整数,无需 str() "sourceApp": "someApp" } }] Payload = json.dumps(payload_dict) - 使用 json.dumps() 不仅能自动处理类型(int → JSON number,str → JSON string),还能安全转义特殊字符、避免语法错误,并提升代码可维护性。
- 若因历史约束必须保留字符串拼接,请务必确认所有数字字段(如 itemNumber、Expiration、sourceTimestamp)均不加引号;而字符串字段(如 Code、Name)必须加双引号并正确转义。
总结:JSON 的数据类型由语法决定——数字无引号,字符串有引号。修复本质不是“转换类型”,而是修正字符串拼接中的 JSON 语法表达。长远来看,弃用手动拼接、拥抱 json 模块,是保障接口健壮性的最佳实践。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











