JSON 与 XML 格式的 API

JSON 和 XML 之间的取舍，同样属于客户端与 API 之间的约定。客户端应当区分成功、校验错误、身份验证失败、速率限制和临时性服务器错误。用 JSON 还是 XML 不会改变 HTTP 语义，而 IPv4/IPv6 值必须原样保存，不能按 IPv4 的长度来假设。

如何处理响应

校验 Content-Type、状态码、文档规定的字段和配额。HTTP 429 要单独处理：响应中带有 Retry-After 时遵循它，并使用有次数上限、带随机抖动（jitter）的指数退避。重试之前先考虑操作是否幂等。日志中可以记录请求标识符、状态和延迟，但绝不能记录 API 密钥。

关键细节

JSON 能自然地对应常见的对象/数组数据模型，通常也更紧凑；XML 则支持属性、命名空间和成熟的 Schema 工具。应该根据 API 约定和所处的生态来选择，而不是想当然地认为某种格式在任何情况下都更快或更正确。当前的 API 约定和真实请求示例，请参阅 2IP API。