Links

Notas
Nível de especialista
A chave da API deve ser enviada como um token de portador no cabeçalho de autorização da solicitação. Obtenha sua chave de API.
Lista

Ponto de extremidade da API:

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

Exemplo de solicitação: 

curl --location --request GET 'https://goo.vc/api/v1/links?pt' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Parâmetro
Tipo
Descrição
search
opcional string
A consulta de pesquisa.
search_by
opcional string
Pesquisar por. Os valores possíveis são: title para Título, alias para Apelido, url para URL. O padrão é: title.
status
opcional integer
Filtrar por status. Os valores possíveis são: 0 para Todos, 1 para Ativo, 2 para Expirado, 3 para Desativado. O padrão é: 0.
space_id
opcional integer
Filtrar por ID do espaço.
domain_id
opcional integer
Filtrar por ID de domínio.
pixel_id
opcional integer
Filtrar por ID de pixel.
sort_by
opcional string
Ordenar por. Os valores possíveis são: id para Data de criação, clicks para Cliques, title para Título, alias para Apelido, url para URL. O padrão é: id.
sort
opcional string
Classificar. Os valores possíveis são: desc para Descendente, asc para Ascendente. O padrão é: desc.
per_page
opcional integer
Resultados por página. Os valores possíveis são: 10, 25, 50, 100. O padrão é: 10.
Mostrar

Ponto de extremidade da API:

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

Exemplo de solicitação: 

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

Ponto de extremidade da API:

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

Exemplo de solicitação: 

curl --location --request POST 'https://goo.vc/api/v1/links?pt' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
Parâmetro
Tipo
Descrição
url
necessário string
O link a ser encurtado.
domain_id
necessário integer
O ID do domínio no qual o link deve ser salvo.
alias
opcional string
O alias do link.
password
opcional string
A senha do link.
space_id
opcional integer
O ID do espaço em que o link deve ser salvo.
pixel_ids
opcional array
The pixel IDs to be integrated in the link.
disabled
opcional integer
Se o link está desativado ou não. Os valores possíveis são: 0 para Ativo, 1 para Desativado. O padrão é: 0.
privacy
opcional integer
Se as estatísticas de links são públicas ou não. Os valores possíveis são: 0 para Público, 1 para Privado, 2 para Senha. O padrão é: 0.
privacy_password
opcional string
A senha da página de estatísticas. Só funciona com privacy definido como 2.
expiration_url
opcional string
O link para o qual o usuário será redirecionado quando o link expirar.
expiration_date
opcional string
A data de expiração do link no formato YYYY-MM-DD.
expiration_time
opcional string
O tempo de expiração do link no formato HH:MM.
expiration_clicks
opcional integer
O número de cliques após os quais o link deve expirar.
target_type
opcional integer
O tipo de direcionamento. Os valores possíveis são: 0 para Nenhum, 1 para Geográfico, 2 para Plataforma, 4 para Rotação.
country[index][key]
opcional string
O código do país de destino. O código deve estar no padrão ISO 3166-1 alpha-2.
country[index][value]
opcional string
O link para o qual o usuário será redirecionado.
platform[index][key]
opcional string
O nome da plataforma de destino. Os valores possíveis são: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opcional string
O link para o qual o usuário será redirecionado.
language[index][key]
opcional string
O código do idioma de destino. O código deve estar no padrão ISO 639-1 alpha-2.
language[index][value]
opcional string
O link para o qual o usuário será redirecionado.
rotation[index][value]
opcional string
O link para o qual o usuário será redirecionado.
Atualização

Ponto de extremidade da API:

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

Exemplo de solicitação: 

curl --location --request PUT 'https://goo.vc/api/v1/links/{id}?pt' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Parâmetro
Tipo
Descrição
url
opcional string
O link a ser encurtado.
alias
opcional string
O alias do link.
password
opcional string
A senha do link.
space_id
opcional integer
O ID do espaço em que o link deve ser salvo.
pixel_ids
opcional array
The pixel IDs to be integrated in the link.
disabled
opcional integer
Se o link está desativado ou não. Os valores possíveis são: 0 para Ativo, 1 para Desativado.
privacy
opcional integer
Se as estatísticas de links são públicas ou não. Os valores possíveis são: 0 para Público, 1 para Privado, 2 para Senha.
privacy_password
opcional string
A senha da página de estatísticas. Só funciona com privacy definido como 2.
expiration_url
opcional string
O link para o qual o usuário será redirecionado quando o link expirar.
expiration_date
opcional string
A data de expiração do link no formato YYYY-MM-DD.
expiration_time
opcional string
O tempo de expiração do link no formato HH:MM.
expiration_clicks
opcional integer
O número de cliques após os quais o link deve expirar.
target_type
opcional integer
O tipo de direcionamento. Os valores possíveis são: 0 para Nenhum, 1 para Geográfico, 2 para Plataforma, 4 para Rotação.
country[index][key]
opcional string
O código do país de destino. O código deve estar no padrão ISO 3166-1 alpha-2.
country[index][value]
opcional string
O link para o qual o usuário será redirecionado.
platform[index][key]
opcional string
O nome da plataforma de destino. Os valores possíveis são: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opcional string
O link para o qual o usuário será redirecionado.
language[index][key]
opcional string
O código do idioma de destino. O código deve estar no padrão ISO 639-1 alpha-2.
language[index][value]
opcional string
O link para o qual o usuário será redirecionado.
rotation[index][value]
opcional string
O link para o qual o usuário será redirecionado.
Excluir

Ponto de extremidade da API:

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

Exemplo de solicitação: 

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