空间

注意事项
专家级
API 密钥应作为 Bearer 令牌在请求的授权标头中发送。 获取您的 API 密钥.
列表

API端点:

GET 
https://link.smartontoline.com/api/v1/spaces

请求示例: 

curl --location --request GET 'https://link.smartontoline.com/api/v1/spaces' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
参数
类型
描述
search
可选的 string
搜索查询
search_by
可选的 string
搜索方式. 可能的值为：名称 的 name 默认为：name
sort_by
可选的 string
排序方式. 可能的值为：创建日期 的 id, 名称 的 name 默认为：id
sort
可选的 string
排序. 可能的值为：降序 的 desc, 升序 的 asc 默认为：desc
per_page
可选的 int
每页结果. 可能的值为：10, 25, 50, 100 默认为：10
查看

API端点:

GET 
https://link.smartontoline.com/api/v1/spaces/{id}

请求示例: 

curl --location --request GET 'https://link.smartontoline.com/api/v1/spaces/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
创建

API端点:

POST 
https://link.smartontoline.com/api/v1/spaces

请求示例: 

curl --location --request POST 'https://link.smartontoline.com/api/v1/spaces' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'name={name}'
参数
类型
描述
name
必需的 string
空间名称
color
可选的 integer
颜色代码 可能的值为：1, 2, 3, 4, 5, 6 默认为：1
更新

API端点:

PUT PATCH 
https://link.smartontoline.com/api/v1/spaces/{id}

请求示例: 

curl --location --request PUT 'https://link.smartontoline.com/api/v1/spaces/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}'
参数
类型
描述
name
可选的 string
空间名称
color
可选的 integer
颜色代码 可能的值为：1, 2, 3, 4, 5, 6
删除

API端点:

DELETE 
https://link.smartontoline.com/api/v1/spaces/{id}

请求示例: 

curl --location --request DELETE 'https://link.smartontoline.com/api/v1/spaces/{id}' \
--header 'Authorization: Bearer {api_key}'