空间

备注
专家级别
API密钥应发送为请求的Authorization头中的Bearer令牌。 获取您的API密钥.
列表

API端点:

GET
https://dlj.cool/api/v1/spaces

请求示例:

curl --location --request GET 'https://dlj.cool/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://dlj.cool/api/v1/spaces/{id}

请求示例:

curl --location --request GET 'https://dlj.cool/api/v1/spaces/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
存储

API端点:

POST
https://dlj.cool/api/v1/spaces

请求示例:

curl --location --request POST 'https://dlj.cool/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://dlj.cool/api/v1/spaces/{id}

请求示例:

curl --location --request PUT 'https://dlj.cool/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://dlj.cool/api/v1/spaces/{id}

请求示例:

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