Bağlantılar

Notlar
Uzman seviyesi
API anahtarı, isteğin Yetkilendirme üstbilgisinde bir Taşıyıcı belirteci olarak gönderilmelidir. API anahtarınızı alın.
Liste

API uç noktası:

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

Talep örneği: 

curl --location --request GET 'https://goo.vc/api/v1/links?tr' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Parametre
Tip
Açıklama
search
opsiyonel string
Arama sorgusu.
search_by
opsiyonel string
Şuna göre ara. Olası değerler şunlardır: Başlık için title, Takma ad için alias, URL için url. Varsayılan değer: title.
status
opsiyonel integer
Duruma göre filtreleyin. Olası değerler şunlardır: Tümü için 0, Aktif için 1, Süresi doldu için 2, Engelli için 3. Varsayılan değer: 0.
space_id
opsiyonel integer
Alan kimliğine göre filtreleyin.
domain_id
opsiyonel integer
Etki alanı kimliğine göre filtreleyin.
pixel_id
opsiyonel integer
Piksel kimliğine göre filtreleyin.
sort_by
opsiyonel string
Göre sırala. Olası değerler şunlardır: Oluşturulduğu tarih için id, Tıklamalar için clicks, Başlık için title, Takma ad için alias, URL için url. Varsayılan değer: id.
sort
opsiyonel string
Sırala. Olası değerler şunlardır: Alçalma için desc, Yükselen için asc. Varsayılan değer: desc.
per_page
opsiyonel integer
Sayfa başına sonuç. Olası değerler şunlardır: 10, 25, 50, 100. Varsayılan değer: 10.
Göster

API uç noktası:

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

Talep örneği: 

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

API uç noktası:

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

Talep örneği: 

curl --location --request POST 'https://goo.vc/api/v1/links?tr' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
Parametre
Tip
Açıklama
url
gerekli string
Kısaltılacak bağlantı.
domain_id
gerekli integer
Bağlantının kaydedileceği alan kimliği.
alias
opsiyonel string
Bağlantı takma adı.
password
opsiyonel string
Bağlantı şifresi.
space_id
opsiyonel integer
Bağlantının kaydedileceği alan kimliği.
pixel_ids
opsiyonel array
The pixel IDs to be integrated in the link.
disabled
opsiyonel integer
Bağlantının devre dışı bırakılıp bırakılmadığı. Olası değerler şunlardır: Aktif için 0, Engelli için 1. Varsayılan değer: 0.
privacy
opsiyonel integer
Bağlantı istatistikleri herkese açık olsun ya da olmasın. Olası değerler şunlardır: Kamu için 0, Özel için 1, Şifre için 2. Varsayılan değer: 0.
privacy_password
opsiyonel string
İstatistik sayfası için parola. Yalnızca privacy değeri 2 olarak ayarlandığında çalışır.
expiration_url
opsiyonel string
Bağlantı sona erdiğinde kullanıcının yönlendirileceği bağlantı.
expiration_date
opsiyonel string
YYYY-MM-DD biçiminde bağlantı son kullanma tarihi.
expiration_time
opsiyonel string
Bağlantı sona erme süresi HH:MM biçiminde.
expiration_clicks
opsiyonel integer
Bağlantının süresinin dolması gereken tıklama sayısı.
target_type
opsiyonel integer
Hedefleme türü. Olası değerler şunlardır: Hiçbiri için 0, Coğrafi için 1, Platform için 2, Rotasyon için 4.
country[index][key]
opsiyonel string
Hedeflenen ülkenin kodu. Kod ISO 3166-1 alpha-2 standardında olmalıdır.
country[index][value]
opsiyonel string
Kullanıcının yönlendirileceği bağlantı.
platform[index][key]
opsiyonel string
Hedeflenen platformun adı. Olası değerler şunlardır: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opsiyonel string
Kullanıcının yönlendirileceği bağlantı.
language[index][key]
opsiyonel string
Hedeflenen dilin kodu. Kod ISO 639-1 alpha-2 standardında olmalıdır.
language[index][value]
opsiyonel string
Kullanıcının yönlendirileceği bağlantı.
rotation[index][value]
opsiyonel string
Kullanıcının yönlendirileceği bağlantı.
Güncelleme

API uç noktası:

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

Talep örneği: 

curl --location --request PUT 'https://goo.vc/api/v1/links/{id}?tr' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Parametre
Tip
Açıklama
url
opsiyonel string
Kısaltılacak bağlantı.
alias
opsiyonel string
Bağlantı takma adı.
password
opsiyonel string
Bağlantı şifresi.
space_id
opsiyonel integer
Bağlantının kaydedileceği alan kimliği.
pixel_ids
opsiyonel array
The pixel IDs to be integrated in the link.
disabled
opsiyonel integer
Bağlantının devre dışı bırakılıp bırakılmadığı. Olası değerler şunlardır: Aktif için 0, Engelli için 1.
privacy
opsiyonel integer
Bağlantı istatistikleri herkese açık olsun ya da olmasın. Olası değerler şunlardır: Kamu için 0, Özel için 1, Şifre için 2.
privacy_password
opsiyonel string
İstatistik sayfası için parola. Yalnızca privacy değeri 2 olarak ayarlandığında çalışır.
expiration_url
opsiyonel string
Bağlantı sona erdiğinde kullanıcının yönlendirileceği bağlantı.
expiration_date
opsiyonel string
YYYY-MM-DD biçiminde bağlantı son kullanma tarihi.
expiration_time
opsiyonel string
Bağlantı sona erme süresi HH:MM biçiminde.
expiration_clicks
opsiyonel integer
Bağlantının süresinin dolması gereken tıklama sayısı.
target_type
opsiyonel integer
Hedefleme türü. Olası değerler şunlardır: Hiçbiri için 0, Coğrafi için 1, Platform için 2, Rotasyon için 4.
country[index][key]
opsiyonel string
Hedeflenen ülkenin kodu. Kod ISO 3166-1 alpha-2 standardında olmalıdır.
country[index][value]
opsiyonel string
Kullanıcının yönlendirileceği bağlantı.
platform[index][key]
opsiyonel string
Hedeflenen platformun adı. Olası değerler şunlardır: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opsiyonel string
Kullanıcının yönlendirileceği bağlantı.
language[index][key]
opsiyonel string
Hedeflenen dilin kodu. Kod ISO 639-1 alpha-2 standardında olmalıdır.
language[index][value]
opsiyonel string
Kullanıcının yönlendirileceği bağlantı.
rotation[index][value]
opsiyonel string
Kullanıcının yönlendirileceği bağlantı.
Silme

API uç noktası:

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

Talep örneği: 

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