
本文详解如何在 php 构建 api 请求时,确保 json 输出中的数值字段(如 stock.value)以原生数字类型(而非字符串)序列化,从而满足接口对数据类型的严格要求。
在调用第三方 API(如 https://partners.services.aaaa.eu/v1/mkpApi/product/save)时,后端常要求 JSON payload 中的数值字段(例如库存 value、价格 sale_price、RRP 等)必须为 整数或浮点数类型,而非字符串。而 PHP 的 $_POST 获取的所有表单数据默认均为字符串类型,若直接赋值给数组再经 json_encode() 序列化,会导致 "value": "200" 这样的无效格式——API 可能拒绝解析或返回校验错误。
你当前代码中关键问题在于:
"stock" => [[
"warehouse_id" => 1,
"value" => $stoc, // ← $stoc 是字符串,如 "200"
]],即使 $stoc = $_POST['stoc'] 输入的是纯数字,PHP 仍将其作为字符串存储。json_encode() 会忠实保留其类型,输出 "value":"200"。
✅ 正确做法:显式类型转换
使用 intval()(整数)或 (float) / floatval()(小数)强制转换,确保数值字段在 JSON 中无引号:
"stock" => [[
"warehouse_id" => 1,
"value" => intval($stoc), // ✅ 输出: "value": 200
]],? 提示:intval() 会截断小数部分;若需支持带小数的库存(如 200.5),请改用 (float)$stoc 或 floatval($stoc)。
同时,建议对其他数值字段也做统一类型校验,提升健壮性:
立即学习“PHP免费学习笔记(深入)”;
"sale_price" => floatval($pret), "rrp" => floatval($rrp), "category_id" => intval($_POST['category_id'] ?? 10008),
⚠️ 注意事项:
- 不要依赖 print $stoc 调试——它仅输出值,不改变变量类型;
- 避免 json_encode() 嵌套调用(如你代码中 http_build_query(["data" => json_encode($payload)])),这会导致双重编码风险;推荐直接发送 JSON 格式请求体(Content-Type: application/json),更规范:
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["data" => $payload])); curl_setopt($ch, CURLOPT_HTTPHEADER, array_merge($headers, ["Content-Type: application/json"]));
- 始终验证输入:if (!is_numeric($stoc)) { die("Invalid stock value"); }
✅ 最终修正后的 stock 片段示例:
"stock" => [[
"warehouse_id" => 1,
"value" => intval($stoc) ?: 0, // 安全兜底:空值转为 0
]],这样,json_encode($payload) 将输出符合 API 规范的纯数字字段:"stock":[{"warehouse_id":1,"value":200}],彻底解决引号包裹问题。











