开户联系QQ:844122

链接

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

API端点:

GET
http://w7r.cn/api/v1/links

请求示例:

curl --location --request GET 'http://w7r.cn/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 默认值为:25
显示

API端点:

GET
http://w7r.cn/api/v1/links/{id}

请求示例:

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

API端点:

POST
http://w7r.cn/api/v1/links

请求示例:

curl --location --request POST 'http://w7r.cn/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
http://w7r.cn/api/v1/links/{id}

请求示例:

curl --location --request PUT 'http://w7r.cn/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
http://w7r.cn/api/v1/links/{id}

请求示例:

curl --location --request DELETE 'http://w7r.cn/api/v1/links/{id}' \
--header 'Authorization: Bearer {api_key}'