Links

Anmerkungen
Expertenebene
Der API-Schlüssel sollte als Bearer-Token im Authorization-Header der Anfrage gesendet werden. Erhalten Sie Ihren API-Schlüssel.
Liste

API-Endpunkt:

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

Beispiel anfordern: 

curl --location --request GET 'https://goo.vc/api/v1/links?de' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Parameter
Typ
Beschreibung
search
optional string
Die Suchanfrage.
search_by
optional string
Suche nach. Mögliche Werte sind: title für Titel, alias für Alias, url für URL. Standardwert ist: title.
status
optional integer
Nach Status filtern. Mögliche Werte sind: 0 für Alle, 1 für Aktiv, 2 für Abgelaufen, 3 für Behinderte. Standardwert ist: 0.
space_id
optional integer
Nach Raum-ID filtern.
domain_id
optional integer
Nach Domänen-ID filtern.
pixel_id
optional integer
Nach Pixel-ID filtern.
sort_by
optional string
Sortieren nach. Mögliche Werte sind: id für Datum der Erstellung, clicks für Klicks, title für Titel, alias für Alias, url für URL. Standardwert ist: id.
sort
optional string
Sortieren. Mögliche Werte sind: desc für Absteigend, asc für Aufsteigend. Standardwert ist: desc.
per_page
optional integer
Ergebnisse pro Seite. Mögliche Werte sind: 10, 25, 50, 100. Standardwert ist: 10.
anzeigen

API-Endpunkt:

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

Beispiel anfordern: 

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

API-Endpunkt:

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

Beispiel anfordern: 

curl --location --request POST 'https://goo.vc/api/v1/links?de' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
Parameter
Typ
Beschreibung
url
erforderlich string
Der Link soll gekürzt werden.
domain_id
erforderlich integer
Die Domain-ID, unter der der Link gespeichert werden soll.
alias
optional string
Der Link-Alias.
password
optional string
Das Link-Passwort.
space_id
optional integer
Die Space-ID, unter der der Link gespeichert werden soll.
pixel_ids
optional array
The pixel IDs to be integrated in the link.
disabled
optional integer
Ob der Link deaktiviert ist oder nicht. Mögliche Werte sind: 0 für Aktiv, 1 für Behinderte. Standardwert ist: 0.
privacy
optional integer
Ob die Link-Statistiken öffentlich sind oder nicht. Mögliche Werte sind: 0 für Öffentlich, 1 für Privat, 2 für Passwort. Standardwert ist: 0.
privacy_password
optional string
Das Passwort für die Statistikseite. Funktioniert nur, wenn privacy auf 2 eingestellt ist.
expiration_url
optional string
Der Link, an den der Benutzer nach Ablauf der Gültigkeit des Links weitergeleitet wird.
expiration_date
optional string
Das Ablaufdatum des Links im Format YYYY-MM-DD.
expiration_time
optional string
Die Ablaufzeit des Links im Format HH:MM.
expiration_clicks
optional integer
Die Anzahl der Klicks, nach denen der Link ablaufen soll.
target_type
optional integer
Die Art der Zielsetzung. Mögliche Werte sind: 0 für Keine, 1 für Geografische Daten, 2 für Plattform, 4 für Drehung.
country[index][key]
optional string
Der Code des Ziellandes. Der Code muss im ISO 3166-1 alpha-2 Standard sein.
country[index][value]
optional string
Der Link, zu dem der Benutzer weitergeleitet wird.
platform[index][key]
optional string
Der Name der anvisierten Plattform. Mögliche Werte sind: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
optional string
Der Link, zu dem der Benutzer weitergeleitet wird.
language[index][key]
optional string
Der Code der Zielsprache. Der Code muss im ISO 639-1 alpha-2 Standard sein.
language[index][value]
optional string
Der Link, zu dem der Benutzer weitergeleitet wird.
rotation[index][value]
optional string
Der Link, zu dem der Benutzer weitergeleitet wird.
Update

API-Endpunkt:

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

Beispiel anfordern: 

curl --location --request PUT 'https://goo.vc/api/v1/links/{id}?de' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Parameter
Typ
Beschreibung
url
optional string
Der Link soll gekürzt werden.
alias
optional string
Der Link-Alias.
password
optional string
Das Link-Passwort.
space_id
optional integer
Die Space-ID, unter der der Link gespeichert werden soll.
pixel_ids
optional array
The pixel IDs to be integrated in the link.
disabled
optional integer
Ob der Link deaktiviert ist oder nicht. Mögliche Werte sind: 0 für Aktiv, 1 für Behinderte.
privacy
optional integer
Ob die Link-Statistiken öffentlich sind oder nicht. Mögliche Werte sind: 0 für Öffentlich, 1 für Privat, 2 für Passwort.
privacy_password
optional string
Das Passwort für die Statistikseite. Funktioniert nur, wenn privacy auf 2 eingestellt ist.
expiration_url
optional string
Der Link, an den der Benutzer nach Ablauf der Gültigkeit des Links weitergeleitet wird.
expiration_date
optional string
Das Ablaufdatum des Links im Format YYYY-MM-DD.
expiration_time
optional string
Die Ablaufzeit des Links im Format HH:MM.
expiration_clicks
optional integer
Die Anzahl der Klicks, nach denen der Link ablaufen soll.
target_type
optional integer
Die Art der Zielsetzung. Mögliche Werte sind: 0 für Keine, 1 für Geografische Daten, 2 für Plattform, 4 für Drehung.
country[index][key]
optional string
Der Code des Ziellandes. Der Code muss im ISO 3166-1 alpha-2 Standard sein.
country[index][value]
optional string
Der Link, zu dem der Benutzer weitergeleitet wird.
platform[index][key]
optional string
Der Name der anvisierten Plattform. Mögliche Werte sind: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
optional string
Der Link, zu dem der Benutzer weitergeleitet wird.
language[index][key]
optional string
Der Code der Zielsprache. Der Code muss im ISO 639-1 alpha-2 Standard sein.
language[index][value]
optional string
Der Link, zu dem der Benutzer weitergeleitet wird.
rotation[index][value]
optional string
Der Link, zu dem der Benutzer weitergeleitet wird.
Löschen

API-Endpunkt:

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

Beispiel anfordern: 

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