Linkuri - Dezvoltatori

Note

Nivel expert

Cheia API trebuie trimisă ca Bearer token în headerul Authorization al requestului. Obține-ți cheia API.

Listează

Endpoint API:

GET

https://curl.ro/api/v1/links

Exemplu de request:

curl --location --request GET 'https://curl.ro/api/v1/links' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'

Parametru

Tip

Descriere

search

opțional string

Interogare de căutare.

search_by

opțional string

Caută după. Valorile posibile sunt: title pentru Titlu, alias pentru Alias, url pentru URL. Valoarea implicită este: title.

status

opțional integer

Stare. Valorile posibile sunt: 0 pentru Toate, 1 pentru Activ, 2 pentru Expirat, 3 pentru Dezactivat. Valoarea implicită este: 0.

space_id

opțional integer

ID spațiu.

domain_id

opțional integer

ID domeniu.

pixel_id

opțional integer

ID pixel.

sort_by

opțional string

Sortează după. Valorile posibile sunt: id pentru Data creării, clicks pentru Clicuri, title pentru Titlu, alias pentru Alias, url pentru URL. Valoarea implicită este: id.

sort

opțional string

Sortează. Valorile posibile sunt: desc pentru Descrescător, asc pentru Crescător. Valoarea implicită este: desc.

per_page

opțional integer

Rezultate pe pagină. Valorile posibile sunt: 10, 25, 50, 100. Valoarea implicită este: 10.

Afișează

Endpoint API:

GET

https://curl.ro/api/v1/links/{id}

Exemplu de request:

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

Stochează

Endpoint API:

POST

https://curl.ro/api/v1/links

Exemplu de request:

curl --location --request POST 'https://curl.ro/api/v1/links' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'

Parametru

Tip

Descriere

url

obligatoriu string

URL destinație.

domain_id

obligatoriu integer

ID domeniu.

alias

opțional string

Alias.

space_id

opțional integer

ID spațiu.

pixel_ids[]

opțional array

ID-urile pixelilor.

redirect_password

opțional string

Parolă redirect.

sensitive_content

opțional integer

Conținut sensibil. Valorile posibile sunt: 0 pentru Nu, 1 pentru Da. Valoarea implicită este: 0.

privacy

opțional integer

Confidențialitate statistici. Valorile posibile sunt: 0 pentru Public, 1 pentru Privat, 2 pentru Parola. Valoarea implicită este: 0.

password

opțional string

Parolă statistici. Funcționează doar cu câmpul privacy setat la 2.

active_period_start_at

opțional string

Data începerii perioadei active în formatul Y-m-d H:i.

active_period_end_at

opțional string

Data incheierii perioadei active în formatul Y-m-d H:i.

clicks_limit

opțional integer

Limita de clicuri.

expiration_url

opțional string

URL de expirare.

targets_type

opțional string

Targetare. Valorile posibile sunt: continents pentru Continents, countries pentru Countries, operating_systems pentru Operating systems, browsers pentru Browsers, languages pentru Languages, devices pentru Devices, rotations pentru Rotations.

targets[index][key]

opțional string

Pentru targets_type=country, valoarea trebuie să fie în formatul ISO 3166-1 alpha-2.
For targets_type=operating_systems, the possible values are iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
Pentru targets_type=browsers, valorile posibile sunt: Chrome, Chromium, Firefox, Firefox Mobile, Edge, Internet Explorer, Mobile Internet Explorer, Vivaldi, Brave, Safari, Opera, Opera Mini, Opera Mobile, Opera Touch, Yandex Browser, UC Browser, Samsung Internet, QQ Browser, BlackBerry Browser, Maxtho.
Pentru targets_type=devices, valorile posibile sunt: Desktop, Mobile, Tablet, Watch, Television.
Pentru targets_type=languages, valoarea trebuie să fie în formatul ISO 639-1 alpha-2.
Pentru targets_type=continents, valorile posibile sunt: AF pentru Africa, AN pentru Antarctica, AS pentru Asia, EU pentru Europe, NA pentru North America, OC pentru Oceania, SA pentru South America.

targets[index][value]

opțional string

URL destinație.

Actualizează

Endpoint API:

PUT PATCH

https://curl.ro/api/v1/links/{id}

Exemplu de request:

curl --location --request PUT 'https://curl.ro/api/v1/links/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'

Parametru

Tip

Descriere

url

opțional string

URL destinație.

alias

opțional string

Alias.

space_id

opțional integer

ID spațiu.

pixel_ids[]

opțional array

ID-urile pixelilor.

redirect_password

opțional string

Parolă redirect.

sensitive_content

opțional integer

Conținut sensibil. Valorile posibile sunt: 0 pentru Nu, 1 pentru Da.

privacy

opțional integer

Confidențialitate statistici. Valorile posibile sunt: 0 pentru Public, 1 pentru Privat, 2 pentru Parola.

password

opțional string

Parolă statistici. Funcționează doar cu câmpul privacy setat la 2.

active_period_start_at

opțional string

Data începerii perioadei active în formatul Y-m-d H:i.

active_period_end_at

opțional string

Data incheierii perioadei active în formatul Y-m-d H:i.

clicks_limit

opțional integer

Limita de clicuri.

expiration_url

opțional string

URL de expirare.

targets_type

opțional string

Targetare. Valorile posibile sunt: continents pentru Continents, countries pentru Countries, operating_systems pentru Operating systems, browsers pentru Browsers, languages pentru Languages, devices pentru Devices, rotations pentru Rotations.

targets[index][key]

opțional string

Pentru targets_type=country, valoarea trebuie să fie în formatul ISO 3166-1 alpha-2.
For targets_type=operating_systems, the possible values are iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
Pentru targets_type=browsers, valorile posibile sunt: Chrome, Chromium, Firefox, Firefox Mobile, Edge, Internet Explorer, Mobile Internet Explorer, Vivaldi, Brave, Safari, Opera, Opera Mini, Opera Mobile, Opera Touch, Yandex Browser, UC Browser, Samsung Internet, QQ Browser, BlackBerry Browser, Maxtho.
Pentru targets_type=devices, valorile posibile sunt: Desktop, Mobile, Tablet, Watch, Television.
Pentru targets_type=languages, valoarea trebuie să fie în formatul ISO 639-1 alpha-2.
Pentru targets_type=continents, valorile posibile sunt: AF pentru Africa, AN pentru Antarctica, AS pentru Asia, EU pentru Europe, NA pentru North America, OC pentru Oceania, SA pentru South America.

targets[index][value]

opțional string

URL destinație.

Șterge

Endpoint API:

DELETE

https://curl.ro/api/v1/links/{id}

Exemplu de request:

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