Logo 5a.si
Mikrostoritev za krajšanje povezav samo za slovenska podjetja

API

Dostop do API-ja lahko pridobijo samo slovenska podjetja po registraciji.

Dodaj kratko URL povezavo

Namen Pridobitev ene kratke povezave, ki bo preusmerjala uporabnike na določeno dolgo povezavo.
Klicni URL https://5a.si/api/?url=[Your_long_url]&prefix=spar&date=01.01.2025
Metoda GET
Obvezni parametri url - dolga povezava, ki jo želite skrajšati, pretvorjena z uporabo funkcije url_encode
Dodatni parametri prefix - predpona za kratko povezavo do imena vašega podjetja (na primer, a5.si/spar-5sdUy)
date - datum, do katerega bo povezava aktivna. Po tem datumu se bo povezava izbrisala in bo ponovno na voljo za uporabo. Privzeto je povezava na voljo 90 dni.
Avtorizacija Za avtorizacijo se uporablja Basic Auth.
V glavi zahteve se doda niz "Authorization: Basic ".base64_encode($username.':'.$password)
Vrnitev vrednosti V telesu odgovora bo vsebovana kratka povezava.
Primer odgovora https://5a.si/gdT9w
Primer v PHP $long_url = 'https://your_site.si/news/198/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_term=spring_shoes&utm_content=ad1';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://5a.si/api/?url='.url_encode($long_url).'&prefix=spar&date=01.01.2025');
curl_setopt($ch, CURLOPT_HEADER, TRUE);
curl_setopt($ch, CURLOPT_NOBODY, TRUE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
$short_url = curl_exec($ch);
curl_close($ch);

Dodaj več kratkih URL povezav

Namen Pridobitev več kratkih povezav, ki bodo preusmerjale uporabnike na določene dolge povezave.
Klicni URL https://5a.si/api/
Metoda POST
Obvezni parametri urls - seznam dolgih povezav, ki jih želite skrajšati, v formatu JSON
Dodatni parametri prefix - predpona za kratko povezavo do imena vašega podjetja (na primer, a5.si/spar-5sdUy)
date - datum, do katerega bo povezava aktivna. Po tem datumu se bo povezava izbrisala in bo ponovno na voljo za uporabo. Privzeto je povezava na voljo 90 dni.
Avtorizacija Za avtorizacijo se uporablja Basic Auth.
V glavi zahteve se doda niz "Authorization: Basic ".base64_encode($username.':'.$password)
Vrnitev vrednosti V telesu odgovora bo vsebovan seznam dolgih povezav in ustreznih kratkih povezav v formatu JSON.
Primer odgovora {
   "https://your_site.si/news/198/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_term=spring_shoes&utm_content=ad1": "https://5a.si/gdT9w1",
   "https://your_site.si/news/201/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_term=spring_shoes&utm_content=ad1": "https://5a.si/4bF8c2",
   "https://your_site.si/news/215/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_term=spring_shoes&utm_content=ad1": "https://5a.si/h9T6z3"
}
Primer v PHP $ar_long_urls = array(
   'https://your_site.si/news/198/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_term=spring_shoes&utm_content=ad1',
   'https://your_site.si/news/201/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_term=spring_shoes&utm_content=ad1',
   'https://your_site.si/news/215/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_term=spring_shoes&utm_content=ad1',
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://5a.si/api/?url='.url_encode($long_url));
curl_setopt($ch, CURLOPT_HEADER, TRUE);
curl_setopt($ch, CURLOPT_NOBODY, TRUE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, array('url' => json_encode($ar_long_urls), 'prefix' => 'spar', 'date' => '01.01.2025'));
$ar_short_urls = curl_exec($ch);
$ar_short_urls = json_encode($ar_short_urls);
curl_close($ch);

Rezervacija kratkih URL povezav

Če želite doseči največjo zmogljivost dodajanja kratkih povezav v sporočila in anonimnost dolgih povezav, potem:
  1. S pomočjo metode "Dodaj več kratkih URL povezav" vnaprej ustvarite veliko kratkih povezav na osnovi vmesnih povezav.
  2. Te vmesne povezave morajo kazati na poseben razdelek vaše spletne strani in vsebovati ID vmesne povezave. Na primer, https://your_site.si/short_url/?ID=[ID_of_middle_link].
  3. V podatkovni bazi vaše spletne strani shranite ustreznost med ID vmesne povezave in pridobljeno kratko povezavo.
  4. Pri dodajanju dolge povezave v sporočilo uporabniku boste lahko uporabili že pripravljeno kratko povezavo iz podatkovne baze.
  5. Pri tem je treba shraniti v isto tabelo v podatkovni bazi ustreznost med kratko povezavo in dolgo povezavo.
Ta možnost deluje na naslednji način:
  1. Uporabnik klikne na kratko povezavo.
  2. Naša storitev preusmeri uporabnika na vmesno povezavo.
  3. Vaša spletna stran po parametru ID iz vmesne povezave v podatkovni bazi najde dolgo povezavo.
  4. Uporabnik je preusmerjen na dolgo povezavo.
Prednosti:
  1. Za generiranje vsake kratke povezave vam ni treba čakati na odgovor naše storitve.
  2. Nihče razen vas ne ve, kam bo preusmerjen uporabnik.
  3. Lahko popolnoma nadzorujete (štejete, dovoljujete ali prepovedujete) klike na povezave še preden pride do klika na dolgo povezavo.

Kontakti

Če želite preizkusiti, naročiti našo storitev ali imate vprašanja, nas kontaktirajte na spodaj navedene kontakte.
Z veseljem vam bomo pomagali pri razvoju vašega poslovanja ali odgovorili na vaša vprašanja.
Elektronska pošta: info@5a.si
Telefon: +386 69 834 300