Links

Notes
Expert level
The API key should be sent as a Bearer token in the Authorization header of the request. Erhalten Sie Ihren API-Schlüssel.
Liste

API endpoint:

GET 
https://4or.de/api/v1/links

Beispiel anfordern: 

curl --location --request GET 'https://4or.de/api/v1/links' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Parameter
Type
Beschreibung
search
optional string
Die Suchanfrage.
search_by
optional string
Suche nach. Mögliche Werte sind: title for Title, alias for Alias, url for URL. Standardwert: title
status
optional integer
Filtern nach Status. Mögliche Werte sind: 0 for Alle, 1 for Aktiv, 2 for Abgelaufen, 3 for Deaktiviert. Standardwert: 0
space_id
optional integer
Filtern nach Space-ID.
domain_id
optional integer
Nach Domain-ID filtern.
pixel_id
optional integer
Filtern nach Pixel-ID.
sort_by
optional string
Sortieren nach. Mögliche Werte sind: id for Erstellungsdatum, clicks for Klicks, title for Title, alias for Alias, url for URL. Standardwert: id
sort
optional string
Sortieren. Mögliche Werte sind: desc for Absteigend, asc for Aufsteigend. Standardwert: desc
per_page
optional integer
Ergebnisse pro Seite. Mögliche Werte sind: 10, 25, 50, 100. Standardwert: 100
anzeigen

API endpoint:

GET 
https://4or.de/api/v1/links/{id}

Beispiel anfordern: 

curl --location --request GET 'https://4or.de/api/v1/links/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Speichern

API endpoint:

POST 
https://4or.de/api/v1/links

Beispiel anfordern: 

curl --location --request POST 'https://4or.de/api/v1/links' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
Parameter
Type
Beschreibung
url
erforderlich string
Der Link der verkürzt werden soll.
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 die Verknüpfung deaktiviert ist oder nicht. Mögliche Werte sind: 0 for Aktiv, 1 for Deaktiviert. Standardwert: 0
privacy
optional integer
Ob die Link-Statistiken öffentlich sind oder nicht. Mögliche Werte sind: 0 for Öffentlich, 1 for Privat, 2 for Passwort. Standardwert: 0
privacy_password
optional string
The password for the statistics page. Only works with privacy set to 2.
expiration_url
optional string
Der Link, auf den der Benutzer weitergeleitet wird, wenn der Link abgelaufen ist.
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
The number of clicks after which the link should expire.
target_type
optional integer
The type of targeting. Mögliche Werte sind: 0 for Keine, 1 for Geografisch, 2 for Plattform, 4 for Rotation.
country[index][key]
optional string
The code of the targeted country. The code must be in ISO 3166-1 alpha-2 standard.
country[index][value]
optional string
The link where the user will be redirected to.
platform[index][key]
optional string
The name of the targeted platform. Mögliche Werte sind: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
optional string
The link where the user will be redirected to.
language[index][key]
optional string
The code of the targeted language. The code must be in ISO 639-1 alpha-2 standard.
language[index][value]
optional string
The link where the user will be redirected to.
rotation[index][value]
optional string
The link where the user will be redirected to.
Aktualisieren

API endpoint:

PUT PATCH 
https://4or.de/api/v1/links/{id}

Beispiel anfordern: 

curl --location --request PUT 'https://4or.de/api/v1/links/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Parameter
Type
Beschreibung
url
optional string
Der Link der verkürzt 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 die Verknüpfung deaktiviert ist oder nicht. Mögliche Werte sind: 0 for Aktiv, 1 for Deaktiviert.
privacy
optional integer
Ob die Link-Statistiken öffentlich sind oder nicht. Mögliche Werte sind: 0 for Öffentlich, 1 for Privat, 2 for Passwort.
privacy_password
optional string
The password for the statistics page. Only works with privacy set to 2.
expiration_url
optional string
Der Link, auf den der Benutzer weitergeleitet wird, wenn der Link abgelaufen ist.
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
The number of clicks after which the link should expire.
target_type
optional integer
The type of targeting. Mögliche Werte sind: 0 for Keine, 1 for Geografisch, 2 for Plattform, 4 for Rotation.
country[index][key]
optional string
The code of the targeted country. The code must be in ISO 3166-1 alpha-2 standard.
country[index][value]
optional string
The link where the user will be redirected to.
platform[index][key]
optional string
The name of the targeted platform. Mögliche Werte sind: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
optional string
The link where the user will be redirected to.
language[index][key]
optional string
The code of the targeted language. The code must be in ISO 639-1 alpha-2 standard.
language[index][value]
optional string
The link where the user will be redirected to.
rotation[index][value]
optional string
The link where the user will be redirected to.
Löschen

API endpoint:

DELETE 
https://4or.de/api/v1/links/{id}

Beispiel anfordern: 

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