添加一条数据 POST

通过以下接口，您可以往 T1 后端云应用 NoSQL 数据库中添加一条数据。

http://您已备案域名/v5/classes/<collection_name>

INFO

数据添加成功后，系统会自动创建 createdAt 以及 updatedAt 字段（若往不存在的集合中添加数据时，系统会自动创建该集合）。

Date 类型

由于 JSON 数据中只存在字符串类型，不存在 Date 类型数据。因此，您可以使用系统内置 Date 函数，将 RFC3339 格式的日期时间类型的字符串转换为 Date 类型（⚠️ 注意：一定要是 RFC3339 规范的才能被正确转换）。

{
    "name": "王华",
    "age": 21,
    "sex": "男",
    "birthday": "Date('2002-07-09T00:00:00Z')"
}

请求示例

注意修改大括号中的内容。App ID、API Key、Secret Key 请前往仪表盘获取。sign 为签名，签名方式详见请求签名。

cURL

curl --location --request POST 'http://您已备案域名/v5/classes/<collection_name>' \
--header 'X-T1Y-Application-ID: {{app_id}}' \
--header 'X-T1Y-Api-Key: {{api_key}}' \
--header 'X-T1Y-Safe-NonceStr: {{客户端随机生成的32位随机码}}' \
--header 'X-T1Y-Safe-Timestamp: {{Unix时间戳，精确到秒}}' \
--header 'X-T1Y-Safe-Sign: {{MD5(path+app_id+api_key+客户端随机生成的32位随机码+Unix时间戳+Secret_Key)}}' \
--header 'Content-Type: application/json' \
--data-raw '{"name": "王华", "age": 21, "sex": "男", "birthday": "Date('2002-07-09T00:00:00Z')"}'

cURL-Windows

curl --location --request POST "http://您已备案域名/v5/classes/<collection_name>" ^
--header "X-T1Y-Application-ID: {{app_id}}" ^
--header "X-T1Y-Api-Key: {{api_key}}" ^
--header "X-T1Y-Safe-NonceStr: {{客户端随机生成的32位随机码}}" ^
--header "X-T1Y-Safe-Timestamp: {{Unix时间戳，精确到秒}}" ^
--header "X-T1Y-Safe-Sign: {{MD5(path+app_id+api_key+客户端随机生成的32位随机码+Unix时间戳+Secret_Key)}}" ^
--header "Content-Type: application/json" ^
--data-raw "{\"name\": \"王华\", \"age\": 21, \"sex\": \"男\", \"birthday\": \"Date('2002-07-09T00:00:00Z')\"}"

响应示例

操作成功时 http 状态码以及 code 永远是 200。创建成功会返回 objectId ，该 ID 是该数据的唯一标识信息。若需校验响应数据请参考响应签名校验（可选）。

成功示例

{
    "code": 200,
    "data": {
        "objectId": "65435f093b239fddbc3f646e"
    },
    "message": "ok"
}

异常示例

{
    "code": 400,
    "data": null,
    "message": "This is an exception message."
}