Collegamenti

Note
Livello esperto
La chiave API deve essere inviata come token Bearer nell'intestazione Authorization della richiesta. Ottenere la chiave API.
Elenco

Punto finale API:

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

Esempio di richiesta: 

curl --location --request GET 'https://goo.vc/api/v1/links?it' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Parametro
Tipo
Descrizione
search
opzionale string
La query di ricerca.
search_by
opzionale string
Ricerca per. I valori possibili sono: title per Titolo, alias per Alias, url per URL. Il valore predefinito è: title.
status
opzionale integer
Filtrare per stato. I valori possibili sono: 0 per Tutti, 1 per Attivo, 2 per Scaduto, 3 per Disabili. Il valore predefinito è: 0.
space_id
opzionale integer
Filtrare per ID spazio.
domain_id
opzionale integer
Filtrare per ID dominio.
pixel_id
opzionale integer
Filtrare per ID pixel.
sort_by
opzionale string
Ordina per. I valori possibili sono: id per Data di creazione, clicks per Clic, title per Titolo, alias per Alias, url per URL. Il valore predefinito è: id.
sort
opzionale string
Ordinamento. I valori possibili sono: desc per In discesa, asc per In salita. Il valore predefinito è: desc.
per_page
opzionale integer
Risultati per pagina. I valori possibili sono: 10, 25, 50, 100. Il valore predefinito è: 10.
Mostra

Punto finale API:

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

Esempio di richiesta: 

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

Punto finale API:

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

Esempio di richiesta: 

curl --location --request POST 'https://goo.vc/api/v1/links?it' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
Parametro
Tipo
Descrizione
url
richiesto string
Il link da accorciare.
domain_id
richiesto integer
L'ID del dominio con cui salvare il link.
alias
opzionale string
L'alias del collegamento.
password
opzionale string
La password del link.
space_id
opzionale integer
Lo spazio ID in cui salvare il link.
pixel_ids
opzionale array
The pixel IDs to be integrated in the link.
disabled
opzionale integer
Se il collegamento è disabilitato o meno. I valori possibili sono: 0 per Attivo, 1 per Disabili. Il valore predefinito è: 0.
privacy
opzionale integer
Se le statistiche dei link sono pubbliche o meno. I valori possibili sono: 0 per Pubblico, 1 per Privato, 2 per Password. Il valore predefinito è: 0.
privacy_password
opzionale string
La password per la pagina delle statistiche. Funziona solo con privacy impostato su 2.
expiration_url
opzionale string
Il link a cui l'utente sarà reindirizzato una volta scaduto il link.
expiration_date
opzionale string
La data di scadenza del link nel formato YYYY-MM-DD.
expiration_time
opzionale string
L'ora di scadenza del collegamento nel formato HH:MM.
expiration_clicks
opzionale integer
Il numero di clic dopo il quale il link deve scadere.
target_type
opzionale integer
Il tipo di target. I valori possibili sono: 0 per Nessuno, 1 per Geografico, 2 per Piattaforma, 4 per Rotazione.
country[index][key]
opzionale string
Il codice del Paese di destinazione. Il codice deve essere in standard ISO 3166-1 alpha-2.
country[index][value]
opzionale string
Il link a cui l'utente verrà reindirizzato.
platform[index][key]
opzionale string
Il nome della piattaforma mirata. I valori possibili sono: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opzionale string
Il link a cui l'utente verrà reindirizzato.
language[index][key]
opzionale string
Il codice della lingua desiderata. Il codice deve essere in standard ISO 639-1 alpha-2.
language[index][value]
opzionale string
Il link a cui l'utente verrà reindirizzato.
rotation[index][value]
opzionale string
Il link a cui l'utente verrà reindirizzato.
Aggiornamento

Punto finale API:

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

Esempio di richiesta: 

curl --location --request PUT 'https://goo.vc/api/v1/links/{id}?it' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Parametro
Tipo
Descrizione
url
opzionale string
Il link da accorciare.
alias
opzionale string
L'alias del collegamento.
password
opzionale string
La password del link.
space_id
opzionale integer
Lo spazio ID in cui salvare il link.
pixel_ids
opzionale array
The pixel IDs to be integrated in the link.
disabled
opzionale integer
Se il collegamento è disabilitato o meno. I valori possibili sono: 0 per Attivo, 1 per Disabili.
privacy
opzionale integer
Se le statistiche dei link sono pubbliche o meno. I valori possibili sono: 0 per Pubblico, 1 per Privato, 2 per Password.
privacy_password
opzionale string
La password per la pagina delle statistiche. Funziona solo con privacy impostato su 2.
expiration_url
opzionale string
Il link a cui l'utente sarà reindirizzato una volta scaduto il link.
expiration_date
opzionale string
La data di scadenza del link nel formato YYYY-MM-DD.
expiration_time
opzionale string
L'ora di scadenza del collegamento nel formato HH:MM.
expiration_clicks
opzionale integer
Il numero di clic dopo il quale il link deve scadere.
target_type
opzionale integer
Il tipo di target. I valori possibili sono: 0 per Nessuno, 1 per Geografico, 2 per Piattaforma, 4 per Rotazione.
country[index][key]
opzionale string
Il codice del Paese di destinazione. Il codice deve essere in standard ISO 3166-1 alpha-2.
country[index][value]
opzionale string
Il link a cui l'utente verrà reindirizzato.
platform[index][key]
opzionale string
Il nome della piattaforma mirata. I valori possibili sono: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opzionale string
Il link a cui l'utente verrà reindirizzato.
language[index][key]
opzionale string
Il codice della lingua desiderata. Il codice deve essere in standard ISO 639-1 alpha-2.
language[index][value]
opzionale string
Il link a cui l'utente verrà reindirizzato.
rotation[index][value]
opzionale string
Il link a cui l'utente verrà reindirizzato.
Cancellare

Punto finale API:

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

Esempio di richiesta: 

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