本文档旨在帮助开发者解决在使用 PHP 向 REST API 发送 POST 请求时，构建包含混合数组和对象的复杂 JSON 数据结构的问题。我们将重点关注如何正确格式化数据，特别是嵌套数组和对象，以满足 API 的验证要求。通过示例代码和详细解释，你将学会如何避免常见的"missing_entity - addresses - validation_failure"错误，并成功地将数据发送到 API。
在与 REST API 交互时，确保发送的数据格式与 API 期望的格式完全一致至关重要。尤其是在处理包含混合数组和对象的复杂 JSON 结构时，细微的差异可能导致 API 验证失败。
常见的错误是由于对数组和对象的嵌套关系理解不准确造成的。例如，API 可能期望一个包含多个地址对象的数组，但 PHP 代码却构建了一个包含单个地址对象的对象。
解决此问题的关键在于仔细检查 API 文档，了解其期望的数据结构。然后，使用 PHP 正确地构建数组和对象，并使用 json_encode() 函数将其转换为 JSON 字符串。
立即学习“PHP免费学习笔记（深入）”；
示例：地址信息的正确构建方式
假设 API 期望的 JSON 结构如下：
{
"version": 0,
"roles": {
"customer": {
}
},
"person": {
"firstName": "Inge",
"lastName": "Musterfrau"
},
"emailAddresses" :{
"private" : [
"email@example.com"
]
},
"addresses": {
"billing": [
{
"supplement": null,
"street": "aaa",
"zip": "12345",
"city": "Berlin",
"countryCode": "DE"
}
]
}
}其中，addresses 字段包含一个 billing 字段，而 billing 字段是一个包含地址对象的数组。
Easily find JSON paths within JSON objects using our intuitive Json Path Finder
30
以下是 PHP 中构建此结构的正确方法：
<?php
$billingAddress = [
"streetDetails" => null,
"street" => "aaa",
"zipCode" => "12345",
"city" => "Berlin",
"country" => "DE"
];
$billingAddr = array(
"supplement" => $billingAddress["streetDetails"],
"street" => $billingAddress["street"],
"zip" => $billingAddress["zipCode"],
"city" => $billingAddress["city"],
"countryCode" => $billingAddress["country"],
);
$roles = null;
$person = null;
$emailAddresses = null;
$params = [
"version" => 0,
"roles" => $roles,
"person" => $person,
"emailAddresses" => $emailAddresses,
"addresses" => [
"billing" => [$billingAddr]
]
];
echo json_encode($params, JSON_PRETTY_PRINT);
?>关键点：
错误示例：
以下代码会导致 missing_entity - addresses - validation_failure 错误，因为它将 $billingAddr 直接赋值给 billing 字段，而不是将其放入数组中。
$params = [
"version" => 0,
"roles" => $roles,
"person" => $person,
"emailAddresses" => $emailAddresses,
"addresses" => [
"billing" => $billingAddr // 错误：billing 字段应该是一个数组
]
];构建好 JSON 数据后，可以使用 curl 或其他 HTTP 客户端库将其发送到 API。
<?php
$url = 'YOUR_API_ENDPOINT'; // 替换为你的 API 端点
$data = json_encode($params);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json'
));
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>注意事项：
正确构建 JSON 数据是成功与 REST API 交互的关键。通过仔细阅读 API 文档，并使用 PHP 正确地构建数组和对象，你可以避免常见的验证错误，并确保数据能够成功发送到 API。 记住，json_encode() 函数可以将 PHP 数组和对象转换为 JSON 字符串，以便通过 HTTP 发送。
以上就是使用 PHP 构建符合 REST API 要求的复杂 JSON 数据的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
612
收藏
