链接

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

API端点:

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

请求示例: 

curl --location --request GET 'https://dlj.cool/api/v1/links' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
参数
类型
描述
search
可选的 string
搜索查询。
search_by
可选的 string
搜索方式. 可能的值为：标题 的 title, 别名 的 alias, 链接 的 url。 默认为：title。
status
可选的 integer
按状态过滤。 可能的值为：全部 的 0, 激活 的 1, 已过期 的 2, 禁用 的 3。 默认为：0。
space_id
可选的 integer
按空间ID过滤。
domain_id
可选的 integer
按域名ID过滤。
pixel_id
可选的 integer
按像素 ID 过滤。
sort_by
可选的 string
排序方式. 可能的值为：创建日期 的 id, 点击量 的 clicks, 标题 的 title, 别名 的 alias, 链接 的 url。 默认为：id。
sort
可选的 string
排序. 可能的值为：降序 的 desc, 升序 的 asc。 默认为：desc。
per_page
可选的 int
每页结果数. 可能的值为：10, 25, 50, 100。 默认为：10。
展示

API端点:

GET 
https://dlj.cool/api/v1/links/{id}

请求示例: 

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

API端点:

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

请求示例: 

curl --location --request POST 'https://dlj.cool/api/v1/links' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
参数
类型
描述
url
必须的 string
要缩短的链接。
domain_id
必须的 integer
要保存链接下的域名ID。
alias
可选的 string
链接别名。
password
可选的 string
链接密码。
space_id
可选的 integer
要保存链接下的空间ID。
pixel_ids
可选的 array
The pixel IDs to be integrated in the link.
disabled
可选的 integer
链接是否已禁用。 可能的值为：激活 的 0, 禁用 的 1。 默认为：0。
privacy
可选的 integer
链接统计信息是否公开。 可能的值为：公开 的 0, 私密 的 1, 密码 的 2。 默认为：0。
privacy_password
可选的 string
统计页面的密码。 仅在 privacy 设置为 2 时有效。
expiration_url
可选的 string
链接到期后用户将被重定向到的链接。
expiration_date
可选的 string
链接失效日期，格式为：YYYY-MM-DD。
expiration_time
可选的 string
链接失效时间，格式为：HH:MM。
expiration_clicks
可选的 integer
链接失效之前的点击次数。
target_type
可选的 integer
定位类型。 可能的值为：无 的 0, 地理位置 的 1, 平台 的 2, 旋转 的 4。
country[index][key]
可选的 string
目标国家的代码。 代码必须符合 ISO 3166-1 alpha-2 标准。
country[index][value]
可选的 string
用户将被重定向到的链接。
platform[index][key]
可选的 string
目标平台的名称。 可能的值为：iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS。
platform[index][value]
可选的 string
用户将被重定向到的链接。
language[index][key]
可选的 string
目标语言的代码。 代码必须符合 ISO 639-1 alpha-2 标准。
language[index][value]
可选的 string
用户将被重定向到的链接。
rotation[index][value]
可选的 string
用户将被重定向到的链接。
更新

API端点:

PUT PATCH 
https://dlj.cool/api/v1/links/{id}

请求示例: 

curl --location --request PUT 'https://dlj.cool/api/v1/links/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
参数
类型
描述
url
可选的 string
要缩短的链接。
alias
可选的 string
链接别名。
password
可选的 string
链接密码。
space_id
可选的 integer
要保存链接下的空间ID。
pixel_ids
可选的 array
The pixel IDs to be integrated in the link.
disabled
可选的 integer
链接是否已禁用。 可能的值为：激活 的 0, 禁用 的 1。
privacy
可选的 integer
链接统计信息是否公开。 可能的值为：公开 的 0, 私密 的 1, 密码 的 2。
privacy_password
可选的 string
统计页面的密码。 仅在 privacy 设置为 2 时有效。
expiration_url
可选的 string
链接到期后用户将被重定向到的链接。
expiration_date
可选的 string
链接失效日期，格式为：YYYY-MM-DD。
expiration_time
可选的 string
链接失效时间，格式为：HH:MM。
expiration_clicks
可选的 integer
链接失效之前的点击次数。
target_type
可选的 integer
定位类型。 可能的值为：无 的 0, 地理位置 的 1, 平台 的 2, 旋转 的 4。
country[index][key]
可选的 string
目标国家的代码。 代码必须符合 ISO 3166-1 alpha-2 标准。
country[index][value]
可选的 string
用户将被重定向到的链接。
platform[index][key]
可选的 string
目标平台的名称。 可能的值为：iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS。
platform[index][value]
可选的 string
用户将被重定向到的链接。
language[index][key]
可选的 string
目标语言的代码。 代码必须符合 ISO 639-1 alpha-2 标准。
language[index][value]
可选的 string
用户将被重定向到的链接。
rotation[index][value]
可选的 string
用户将被重定向到的链接。
删除

API端点:

DELETE 
https://dlj.cool/api/v1/links/{id}

请求示例: 

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