Linkuri

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
Interogarea 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
Filtrează după stare. Valorile posibile sunt: 0 pentru Toate, 1 pentru Activ, 2 pentru Expirat, 3 pentru Dezactivat. Valoarea implicită este: 0.
space
opțional integer
Filtrează după ID spațiu.
domain
opțional integer
Filtrează după ID domeniu.
pixel
opțional integer
Filtrează după 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 int
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
Linkul ce urmează să fie scurtat.
domain
obligatoriu integer
ID-ul domeniului în care linkul să fie salvat.
alias
opțional string
Aliasul linkului.
password
opțional string
Parola linkului.
space
opțional integer
ID-ul spațiului în care linkul să fie salvat.
pixels
opțional array
ID-urile pixelilor ce urmează a fi integrați în link.
disabled
opțional integer
Dacă linkul este dezactivat sau nu. Valorile posibile sunt: 0 pentru Activ, 1 pentru Dezactivat. Valoarea implicită este: 0.
privacy
opțional integer
Dacă statisticile linkului sunt publice sau nu. Valorile posibile sunt: 0 pentru Public, 1 pentru Privat, 2 pentru Parola. Valoarea implicită este: 0.
privacy_password
opțional string
Parola pentru pagina statisticilor. Funcționează doar cu privacy setat la 2.
expiration_url
opțional string
Linkul către care utilizatorul va fi redirecționat odată ce linkul a expirat.
expiration_date
opțional string
Data de expirare a linkului în format YYYY-MM-DD.
expiration_time
opțional string
Ora de expirare a linkului în format HH:MM.
expiration_clicks
opțional integer
Numărul de clicuri după care linkul să expire.
target_type
opțional integer
Tipul targetării. Valorile posibile sunt: 0 pentru Nici unul, 1 pentru Geografic, 2 pentru Platformă, 4 pentru Rotație.
country[index][key]
opțional string
Codul țării targetate. Codul trebuie să fie în standardul ISO 3166-1 alpha-2.
country[index][value]
opțional string
Linkul către care va fi redirecționat utilizatorul.
platform[index][key]
opțional string
Numele platformei targetate. Valorile posibile sunt: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opțional string
Linkul către care va fi redirecționat utilizatorul.
language[index][key]
opțional string
Codul limbii targetate. Codul trebuie să fie în standardul ISO 639-1 alpha-2.
language[index][value]
opțional string
Linkul către care va fi redirecționat utilizatorul.
rotation[index][value]
opțional string
Linkul către care va fi redirecționat utilizatorul.
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
Linkul ce urmează să fie scurtat.
alias
opțional string
Aliasul linkului.
password
opțional string
Parola linkului.
space
opțional integer
ID-ul spațiului în care linkul să fie salvat.
pixels
opțional array
ID-urile pixelilor ce urmează a fi integrați în link.
disabled
opțional integer
Dacă linkul este dezactivat sau nu. Valorile posibile sunt: 0 pentru Activ, 1 pentru Dezactivat.
privacy
opțional integer
Dacă statisticile linkului sunt publice sau nu. Valorile posibile sunt: 0 pentru Public, 1 pentru Privat, 2 pentru Parola.
privacy_password
opțional string
Parola pentru pagina statisticilor. Funcționează doar cu privacy setat la 2.
expiration_url
opțional string
Linkul către care utilizatorul va fi redirecționat odată ce linkul a expirat.
expiration_date
opțional string
Data de expirare a linkului în format YYYY-MM-DD.
expiration_time
opțional string
Ora de expirare a linkului în format HH:MM.
expiration_clicks
opțional integer
Numărul de clicuri după care linkul să expire.
target_type
opțional integer
Tipul targetării. Valorile posibile sunt: 0 pentru Nici unul, 1 pentru Geografic, 2 pentru Platformă, 4 pentru Rotație.
country[index][key]
opțional string
Codul țării targetate. Codul trebuie să fie în standardul ISO 3166-1 alpha-2.
country[index][value]
opțional string
Linkul către care va fi redirecționat utilizatorul.
platform[index][key]
opțional string
Numele platformei targetate. Valorile posibile sunt: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opțional string
Linkul către care va fi redirecționat utilizatorul.
language[index][key]
opțional string
Codul limbii targetate. Codul trebuie să fie în standardul ISO 639-1 alpha-2.
language[index][value]
opțional string
Linkul către care va fi redirecționat utilizatorul.
rotation[index][value]
opțional string
Linkul către care va fi redirecționat utilizatorul.
Ș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}'