链接

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

API端点:

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

请求示例: 

curl --location --request GET 'https://link.smartontoline.com/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
可选的 integer
按空间 ID 筛选
domain
可选的 integer
按域名 ID 筛选
pixel
可选的 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://link.smartontoline.com/api/v1/links/{id}

请求示例: 

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

API端点:

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

请求示例: 

curl --location --request POST 'https://link.smartontoline.com/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
必需的 integer
链接要使用的域名 ID
alias
可选的 string
链接后缀
password
可选的 string
链接密码
space
可选的 integer
链接要使用的空间 ID
pixels
可选的 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://link.smartontoline.com/api/v1/links/{id}

请求示例: 

curl --location --request PUT 'https://link.smartontoline.com/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
可选的 integer
链接要使用的空间 ID
pixels
可选的 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://link.smartontoline.com/api/v1/links/{id}

请求示例: 

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