新增单条记录

POST /hserve/v2.2/table/:table_name/record/

本接口提供数据写入功能,其中 :table_name 需替换为你的数据表名称

参数说明

参数类型必填说明
keykey 字段对应的数据类型Ykey 应为数据表中定义的字段名
  • 插入的数据要与预先在知晓云平台设定的数据类型一致
  • 若插入数据中包含 created_by, created_at, updated_at 这几个字段,则最终生成的数据中这几个字段将以插入数据中设置的字段值为准。

请求示例

  1. curl -X POST \
  2. -H "X-Hydrogen-Client-ID: [[client_id]]" \
  3. -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  4. -H "Content-Type: application/json" \
  5. -d '{"name":"nickname","desc":"desc","created_by":767911111}' \
  6. https://{{服务器域名}}/hserve/v2.2/table/test_table/record/

如果需要在数据表中存储文件,文件类型的字段必须要包含 id, name, created_at, mime_type, cdn_path, size 这几个属性,如果文件类型的字段没有保存成功,请检查文件字段有没有包含这几个属性

返回参数说明

参数类型说明
idstringid, 唯一标识
created_atinteger创建时间
updated_atinteger更新时间
created_byinteger创建者 id
read_permarray读权限
write_permarray写权限

返回示例

  1. {
  2. "_id": "5cbe87f0f1ec740afa429e0c",
  3. "created_at": 1555990512,
  4. "created_by": 767911111,
  5. "id": "5cbe87f0f1ec740afa429e0c",
  6. "desc": "desc",
  7. "read_perm": [
  8. "user:*"
  9. ],
  10. "name": "nickname",
  11. "updated_at": 1555990512,
  12. "write_perm": []
  13. }

批量新增记录

POST /hserve/v2.2/table/:table_name/record/

本接口提供数据批量写入功能,其中 :table_name 需替换为你的数据表名称

参数说明

参数为 object array, 即一个 object 的数组,其中 object 的结构如下:

参数类型必填说明
keykey 字段对应的数据类型Ykey 应为数据表中定义的字段名

请求示例

  1. curl -X POST \
  2. -H "X-Hydrogen-Client-ID: [[client_id]]" \
  3. -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  4. -H "Content-Type: application/json" \
  5. -d '[{"name":"nickname","desc":"desc","created_by":767911111},{"name":"nickname2","desc":"desc2","created_by":767911111}]' \
  6. https://{{服务器域名}}/hserve/v2.2/table/test_table/record/

状态码返回 201 并不说明批量写入数据完全成功,仅代表服务端已收到并处理了这个请求只有当返回的结果中 operation_result 列表中不存在 error 元素时,才可以认为所有数据均写入成功。

返回参数说明

参数类型说明
idstringid, 唯一标识
created_atinteger创建时间
total_countinteger总的待创建记录数
succeedinteger成功创建记录数
operation_resultobject array批量写入每一条数据的结果

返回示例

写入成功时,返回如下:

  1. {
  2. "succeed": 2,
  3. "total_count": 2,
  4. "operation_result": [
  5. {
  6. "success": {
  7. "created_at": 1555991015,
  8. "id": "5cbe89e7f1ec740af442a1f9"
  9. }
  10. },
  11. {
  12. "success": {
  13. "created_at": 1555991015,
  14. "id": "5cbe89e7f1ec740af442a1fa"
  15. }
  16. }
  17. ]
  18. }

写入失败时,返回如下:

  1. {
  2. "succeed": 1,
  3. "total_count": 2,
  4. "operation_result": [
  5. {
  6. "success": {
  7. "id": "5bfe000ce74243582bf2979f",
  8. "created_at": "1543459089"
  9. }
  10. },
  11. {
  12. "error": {
  13. "code": 11000,
  14. "err_msg": "数据写入失败,具体错误信息可联系知晓云微信客服:minsupport3 获取。"
  15. }
  16. }
  17. ]
  18. }