使用Zoho Catalyst Rest API插入数据时遇INVALID_INPUT错误

问题背景 #

通过Rest API向Catalyst Datastore表插入记录时，收到如下错误响应：

{
    "status": "failure",
    "data": {
        "message": "The input value is not readable. Please check your input",
        "error_code": "INVALID_INPUT"
    }
}

使用的关键信息：

• 权限范围：ZohoCatalyst.tables.rows.CREATE
• API地址：https://api.catalyst.zoho.com/baas/v1/project/project_id/table/table_identifier/row
• 请求体：

{
    "customer_id": 1001,
    "customer_name": "Guru",
    "Designation": "Tester"
}

排查与解决方案 #

1. 检查字段名大小写匹配 #

Catalyst Datastore的字段名区分大小写，请求体中的Designation需与表中定义的字段名完全一致。如果表中字段实际为小写的designation，修改请求体字段名即可：

{
    "customer_id": 1001,
    "customer_name": "Guru",
    "designation": "Tester"
}

2. 确认请求头设置 #

必须在请求头中添加Content-Type: application/json，否则服务端无法正确解析JSON请求体，会触发"输入不可读"的错误。同时确保Authorization头携带有效的OAuth令牌：

Authorization: Zoho-oauthtoken <your_access_token>
Content-Type: application/json

3. 验证JSON格式合法性 #

检查请求体的JSON是否存在语法错误，比如遗漏逗号、引号不闭合、多余空格等。可以使用本地或在线JSON校验工具确认格式正确。

4. 匹配字段数据类型 #

确认customer_id在Datastore表中的数据类型：

• 如果表中定义为数字类型，当前传入的1001是合法的；
• 如果表中定义为字符串类型，需将值改为字符串格式："customer_id": "1001"

内容的提问来源于stack exchange，提问作者stella maris