Response to web API requests: 400: Bad request

parse_error

该响应表示您的请求不是有效的 JSON，或缺少某些字段。请更正 JSON 使其有效，并补充缺少的参数。

请求体

参数	类型	描述
errors	Object	source：（字符串）若 JSON 无效，则为 `null`。 errors：错误描述。
error_code	String	错误简称。此处为 `parse_error`。
status_code	Integer	HTTP 状态码。始终为 `400`。

响应示例

{
    "errors": [
        {
            "source": null,
            "errors": [
                "JSON parse error - Expecting ',' delimiter: line 4 column 3 (char 67)"
            ]
        }
    ],
    "error_code": "parse_error",
    "status_code": 400
}

datetime

请求失败，因为 visited_at 字段的格式不正确。请使用 ISO 8601 日期格式，例如 2025-01-14T14:15:22Z。

Body

参数	类型	描述
errors	Object	source：（string）始终为 `visited_at`。 errors：错误描述。
error_code	String	错误简称。此处为：`base_error`。
status_code	Integer	HTTP 状态码。始终为 `400`。

响应示例

{
    "errors": [
        {
            "source": "visited_at",
            "errors": [
                "invalid datetime format"
            ]
        }
    ],
    "error_code": "datetime",
    "status_code": 400
}

enum

请求失败，因为 status 字段的值无效。请检查是否有拼写错误。可用值为 organic、non_organic 和 unknown。

Body

参数	类型	描述
errors	Object	source: (string) 始终为 `status`。 errors: 错误描述。此处为 `value is not a valid enumeration member; permitted: 'organic', 'non_organic', 'unknown'`
error_code	String	简短错误名称。此处为：`enum`。
status_code	Integer	HTTP 状态码。始终为 `400`。

响应示例

{
    "errors": [
        {
            "source": "status",
            "errors": [
                "value is not a valid enumeration member; permitted: 'organic', 'non_organic', 'unknown'"
            ]
        }
    ],
    "error_code": "enum",
    "status_code": 400
}