数据表操作
创建数据表
接口
POST https://cloud.minapp.com/userve/v1.8/table/
提交参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
name | String(32) | 是 | 数据表名(以字母开头,字母、数字、下划线的组合) |
schema | Object | 是 | 数据表字段的元信息 |
row_read_perm | String Array | 是 | 数据表行的默认读权限 |
row_write_perm | String Array | 是 | 数据表行的默认写权限 |
write_perm | String Array | 是 | 数据表的写权限 |
参数 row_read_perm 和 row_write_perm 控制数据表数据的读写权限,读权限表示用户是否有权限获取数据,写权限表示用户是否有权限更新数据。
参数 write_perm 控制数据表的写权限,即表示用户是否有权限创建数据。
权限参数的说明:
参数 | 类型 | 说明 |
---|---|---|
user:anonymous | String | 所有人(临时用户 + 登录用户)可写/所有人(登录用户 + 未登录用户)可读 |
user:* | String | 登录用户(不包含匿名用户)可写/可读 |
user:<:user_id> | String | 某个用户可写/可读 |
gid:<:group_id> | String | 某个分组下的用户可写/可读 |
具体描述与使用场景可参考ACL 访问控制列表。
参数 schema 用于存储数据表字段的元信息,其结构遵循JSON-Table-Schema的描述。
例:
数据表列的元信息:
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
name | String(32) | 是 | 字段名(字母开头,字母、数字、下划线的组合) |
type | String | 是 | 字段类型 |
items | Object | 否 | 列表元素类型,array 字段类型必填 |
format | String | 否 | geojson 字段类型必填,值默认为 |
description | String | 否 | 字段的描述,不填自动赋值为字段名称 |
constraints | Object | 否 | 字段的约束属性,仅支持 required 属性 |
default | 跟字段类型一样 | 否 | 字段的默认值 |
acl | Object | 否 | 字段权限相关的属性 |
coordinate_type | String | 否 | geojson 字段类型必填 |
schema_id | String | 否 | pointer 字段类型必填,表示关联的数据表 ID |
type
目前支持 string、integer、number、boolean、array、geojson、file、date、reference(pointer 类型字段)等items
目前支持 string、integer、number、boolean 等coordinate_type
目前支持 wgs84(地球坐标)、gcj02(火星坐标)
若字段是 array 类型,字段元信息为:
若字段是 geojson 类型,字段元信息为:
若字段是 pointer 类型,字段元信息为:
字段权限相关的属性存储在 acl 中:
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
clientVisibile | Boolean | 否 | 客户端只读的标志位,true 表示字段在客户端只读,不能被写入/更新 |
clientReadOnly | Boolean | 否 | 客户端可见的标志位, false 表示字段在客户端不可见 |
creatorVisible | Boolean | 否 | 客户端创建者可见的标志位,true 表示字段在客户端只有创建者可见 |
代码示例
返回示例
info 字段如 id、created_by、created_at、updated_at 为自动添加的内置字段
返回参数说明
参数 | 类型 | 说明 |
---|---|---|
id | Integer | 数据表 ID |
name | String | 数据表名 |
protected_fields | String Array | 内置表的保护字段,若数据表不是内置表,该字段为 null |
schema | Object | 数据表字段的元信息 |
write_perm | String Array | 数据表写权限 |
default_row_perm | Object | 数据表行数据权限 |
created_at | Integer | 数据表创建时间 |
updated_at | Integer | 数据表更新时间 |
状态码说明
201
: 修改成功
400
: 表名已存在;不合法的数据
获取数据表详情
接口
GET https://cloud.minapp.com/userve/v1.8/table/:table_id/
代码示例
返回示例
状态码说明
200
: 成功
获取数据表列表
接口
GET https://cloud.minapp.com/userve/v1.8/table/
提交参数
name 支持对数据表名的等值查询
https://cloud.minapp.com/userve/v1.8/table/?name=Table
代码示例
返回示例
状态码说明
200
: 成功
更新数据表
接口
PUT https://cloud.minapp.com/userve/v1.8/table/:table_id/
info 数据表更新接口支持一次更新一个或多个字段
代码示例
返回示例
状态码说明
200
: 修改成功
400
: 表名已存在;不合法的数据
删除数据表
接口
DELETE https://cloud.minapp.com/userve/v1.8/table/:table_id/
代码示例
状态码说明
204
: 删除成功
Last updated