链接

说明
专家级
API 密钥应在请求的授权标头中作为承载器令牌发送。 获取 API 密钥.
列表

应用程序接口端点:

GET 
https://goo.vc/api/v1/links?zh

申请示例: 

curl --location --request GET 'https://goo.vc/api/v1/links?zh' \
--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
可选 integer
每页结果. 可能的值是10, 25, 50, 100. 默认为10.
显示

应用程序接口端点:

GET 
https://goo.vc/api/v1/links/{id}?zh

申请示例: 

curl --location --request GET 'https://goo.vc/api/v1/links/{id}?zh' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
商店

应用程序接口端点:

POST 
https://goo.vc/api/v1/links?zh

申请示例: 

curl --location --request POST 'https://goo.vc/api/v1/links?zh' \
--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
用户将被重定向到的链接。
更新

应用程序接口端点:

PUT PATCH 
https://goo.vc/api/v1/links/{id}?zh

申请示例: 

curl --location --request PUT 'https://goo.vc/api/v1/links/{id}?zh' \
--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
用户将被重定向到的链接。
删除

应用程序接口端点:

DELETE 
https://goo.vc/api/v1/links/{id}?zh

申请示例: 

curl --location --request DELETE 'https://goo.vc/api/v1/links/{id}?zh' \
--header 'Authorization: Bearer {api_key}'