Web API

Kukaj.sk API volania ti umožnia, za pomoci jednoduchých Java Script funkcií, použiť rôzne časti tohto servera na tvojej stránke. Tieto API volania sú navrhnuté tak, aby ti sprístupnili Kukaj.sk databázu. Pomocou API funkcií si z nej môžeš vytiahnúť svoje tagy, samostatné videá, video galérie a iné informácie a použiť ich na svojej stránke alebo blogu. Web API sú vhodné hlavne pre zdatnejších blogerov a programátorov, ktorí chcú obohatiť svoje stránky a sprístupniť informácie z tohto servera svojím návšetvníkom.

Tagy

kukaj_tags_request() je funkcia, ktorá z našej databázy vytiahne tagy ku všetkým tvojím videám. Táto funkcia potrebuje nasledovné parametre:

key: Svoj kľúč nájdeš po prihlásení vo svojom profile.
amount: Počet tagov, ktoré ti databáza vráti. Minimálny počet je 10.

Funkciu voláme nasledovne:

<script type="text/javascript" src="http://www.kukaj.sk/wapi/js/"></script>
<div><h3>Moje tagy</h3>
  <script type="text/javascript">
    kukaj_tags_request({key: "a44f8908b7b59a1c9829040b96bfa69b", amount: 30});
  </script>
</div>

Po úspešnom prebehnutí funkcie sa ti späť vrátia náhodne zoredené tagy tvojich videí. Tagy si môžeš sám naštýlovať pomocou CSS. Tagy rozlišujeme podľa frekvencie ich výskytu a nadobúdajú 5 rôznych veľkostí: kt-small, kt-medium, kt-large, kt-x-large a kt-xx-large. Vo svojom CSS musíš vytvoriť triedy (class) pre všetkých 5 skupín a priradiť im požadované štýly. Príklad:

.kt-small {
  font-size: small;
  color: red;
}

Ukážka kukaj_tags_request() pre člena zero_cool:

Moje tagy

Videá

kukaj_video_request() je funkcia, ktorá z našej databázy vytiahne tvoje videá a zoradí ich podľa rôznych kritérií. Táto funkcia potrebuje nasledovné parametre:

key: Svoj kľúč nájdeš po prihlásení vo svojom profile.
amount: Počet videí, ktoré ti databáza vráti. Minimálny počet je 1.
sort: Zoradiť videá podľa: vie - počtu zobrazení, rat - hodnotenia, asc - od najstarších po najnovšie, desc - od najnovších po najstaršie, rand - náhodne.
title: Zobraz - 1, alebo skry - 0 názvy videí.

Funkciu voláme nasledovne:

<script type="text/javascript" src="http://www.kukaj.sk/wapi/js/"></script>
<div><h3>Moje populárne videá</h3>
  <script type="text/javascript">
    kukaj_video_request({key: "a44f8908b7b59a1c9829040b96bfa69b", amount: 6, sort: "vie", title: 0});
  </script>
</div>

Po úspešnom zavolaní funkcie sa ti späť vrátia zoradené náhľady a názvy tvojich videí. Videá si môžeš sám naštýlovať pomocou CSS. Videá sú v <div> kontajneroch a všetky majú rovnakú triedu (class) kv-video. Názvy videí sú v triede kv-title a náhľady v triede kv-thumb. Vo svojom CSS si vytvor tieto 3 triedy (kv-video, kv-title a kv-thumb) a priraď im požadované štýly. Príklad:

.kv-video {
  float: left;
  border: 1px solid #bbb;
  padding: 1px;
  margin: 5px;
}

Ukážka kukaj_video_request() pre člena zero_cool:

Moje populárne videá

Videá skupiny

kukaj_group_request() je funkcia, ktorá z našej databázy vráti videá skupiny na základe skupinového identifikačného čísla. Táto funkcia potrebuje nasledovné parametre:

key: Svoj kľúč nájdeš po prihlásení vo svojom profile.
amount: Počet videí, ktoré ti databáza vráti. Minimálny počet je 1.
sort: Zoradiť videá podľa: vie - počtu zobrazení, rat - hodnotenia, asc - od najstarších po najnovšie, desc - od najnovších po najstaršie, rand - náhodne.
title: Zobraz - 1, alebo skry - 0 názvy videí a skupiny.
group: Identifikačné číslo skupiny (napr. 1000).

Funkciu voláme nasledovne:

<script type="text/javascript" src="http://www.kukaj.sk/wapi/js/"></script>
<div><strong>Videá skupiny</strong>
  <script type="text/javascript">
    kukaj_group_request({key: "a44f8908b7b59a1c9829040b96bfa69b", amount: 5, sort: "vie", title: 1, group: 1000});
  </script>
</div>

Po úspešnom zavolaní funkcie sa ti späť vrátia zoradené náhľady videí, ich názvy a aktuálne meno skupiny. Videá si môžeš sám naštýlovať pomocou CSS. Videá sú v <div> kontajneroch a všetky majú rovnakú triedu (class) kg-video. Názvy videí sú v triede kg-title a náhľady v tride kg-thumb. Aktuálne meno skupiny je v triede kg-name. Vo svojom CSS si vytvor tieto 3 triedy (kg-video, kg-title a kg-name) a priraď im požadované štýly. Príklad:

.kg-name a {
  font-weight: bold;
  color: #333;
}

Ukážka kukaj_group_request() pre skupinu 1000:

Videá skupiny