|
| Alapinformációk |
|
Mostantól folyamatosan megnyítjuk, bővítjük a TVN.HU, xFree.hu, video.xFree.hu, szotar.xFree.hu, tv.xFree.hu, blog.xFree.hu és egyéb szolgáltatásainkhoz kapcsolódó API -t.
A TVN.HU API számos lehetőséget (melyek folyamatosan bővülnek) biztosít a fejlesztők/programozók számára a TVN.HU rendszerével történő kommunikációra.
A TVN.HU API XML, PHP serialize, CSV és JSON (callback lehetőséggel együtt) kódolásban érhető el.
Minden funkció meghívásakor kötelezően meg kell adni egy "API kulcsot (string apikey)" és egy "Kimenet típust (int t)".
Az "API kulcsot" egyszerűen a fenn lévő "TVN.HU API Kulcs létrehozzása" menüponttal lekérdezhető minden regisztrált TVN.HU felhasználó számára.
Jelenleg egy adott API kulccsal egy nap alatt maximum 5000 lekérdezés bonyolítható le.
Természetesen az igényeknek megfelelően növelni fogjuk. Egyedi igények esetén kérjük írjon emailt az Ügyfélszolgálatunk címeire.
A TVN.HU API jelenleg béta állapotban van, ezért hibák előfordulhatnak. Hiba esetén kérjük írjon emailt az Ügyfélszolgálatunk címeire.
A TVN.HU API folyamatos fejlesztés alatt áll. Bármikor, minden előzetes tájékoztatás nélkül megváltoztathatjuk. Kérjük tekintse figyelemmel ezt az oldalt.
Amennyiben megosztaná Velünk vagy a TVN.HU felhasználókkal az Ön által megírt programot, kérjük jelezze felénk.
int t;
- t=2 : XML formátumban kapja a választ
- t=3 : PHP serialize formátumban kapja a választ
- t=4 : JSON formátumban kapja a választ (callback esetén szükséges: callback=1 paraméter)
- t=1 : CSV formátumban kapja a választ
Az API elérésének URL címe: - http://devapi.www.tvn.hu/api.tvn?method=
Példa: - xFree.hu - Képtár Funkció: " xfree.hu.lastPhotos (string apikey, int t, int from, int limit) "
Válasszon:
XML,
PHP serialize,
JSON,
JSON (callback),
CSV
|
 |
|
| tvn.hu.CheckAPIKey (string apikey, int t) |
|
- API Kulcs ellenőrzése.
Szükséges adatok:
string apikey;
int t;
Válasz:
bool APIKeyReturnStatus; //0 : false, 1 : true
|
| 2008-06-01 21:43:46 |
|
| xfree.hu.GetMyAlbumsList (string apikey, int t) |
|
- Saját képtárban lévő albumok listázása.
Szükséges adatok:
string apikey;
int t;
Válasz:
string Owner;
string AlbumName;
string AlbumURL;
int PhotosNumber;
int Visited;
int AlbumID;
int Modified;
int AlbumSize;
|
| 2008-06-01 21:43:46 |
|
| xfree.hu.CreateNewAlbum (string apikey, string AlbumName, int t) |
|
- Új album létrehozzása.
Szükséges adatok:
string apikey;
string AlbumName; // album név, kötelező megadni
int t;
Válasz:
int CreatedAlbumID;
string CreateReturnStatus; //OK,ERROR
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.UploadNewPhoto (string apikey, int AlbumID, string PhotoName, file PHOTO, int t) |
|
- Új kép feltöltése adott Albumba.
Szükséges adatok:
string apikey;
int AlbumID;
string PhotoName;
file PHOTO; // HTTP POST szükséges
int t;
Válasz:
string UploadReturnStatus; // OK, ERROR
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.getAlbumInfoByAid (string apikey, int t, int AlbumID) |
|
- Egy album információjának lekérdezése.
string apikey;
int t; // válasz formátum
int AlbumID; // Album ID azonosító
Válasz:
string Owner;
string AlbumName;
string AlbumURL;
int PhotosNumber;
int AlbumSize;
int AlbumChanged; //timestamp
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.getPhotoInfo (string apikey, int t, int AlbumID, int PhotoID) |
|
- Egy kép informáicójának lekérdezése.
string apikey;
int AlbumID; // Album ID azonosító
int PhotoID; // Photo ID azonosító
int t; // válasz formátum
Válasz:
int AlbumID;
int PhotoID;
string PhotoName;
string Owner;
string AlbumName;
int PhotoSize;
int Uploaded;
string AlbumURL;
string PhotoURL;
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.keresPhotos (string apikey, int t, string search, int page, string username) |
|
- Keresés a TVN.HU felhasználók által megosztott képek között.
Szükséges adatok:
string apikey;
int t;
int page;
// oldalszám: 0 .. 10, 20 db kép találat / oldal
Nem szükséges, de megadható:
string username;
Válasz adatok:
string Owner;
int AlbumID;
int PhotoID;
string AlbumURL;
string PhotoName;
string PhotoThumb;
string PhotoURL;
int PhotoSize;
int Views;
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.lastPhotos (string apikey, int t, int from, int limit) |
|
- Legfrissebb megosztott képek.
Szükséges adatok:
string apikey;
int t;
int from; // 0 .. 100 honnantól (maximum: 100)
int limit; // mennyit szeretnenk lekérni (0..100)
Válasz adatok:
string PhotoName;
string PhotoThumb;
string PhotoURL;
string AlbumName;
int Uploaded;
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.lastAlbums (string apikey, int t, int from, int limit) |
|
- Legfrissebb megosztott albumok.
Szükséges adatok:
string apikey;
int t;
int from; // 0 .. 100 honnantól (maximum: 100)
int limit; // mennyit szeretnenk lekérni (0..100)
Válasz adatok:
string Owner;
string AlbumName;
string AlbumURL;
string PhotosNumber;
int Uploaded;
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.getMostVisitedAlbumsToday (string apikey, int t, int from, int limit) |
|
- Leglátogatottabb albumok a mai napon.
Szükséges adatok:
string apikey;
int t;
int from; // 0 .. 100 honnantól (maximum: 100)
int limit; // mennyit szeretnenk lekérni (0..100)
Válasz adatok:
string Owner;
string AlbumName;
string AlbumURL;
int PhotosNumber;
int Visited;
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.getMostVisitedPhotosToday (string apikey, int t, int from, int limit) |
|
- Leglátogatottabb képek a mai napon.
Szükséges adatok:
string apikey;
int t;
int from; // 0 .. 100 honnantól (maximum: 100)
int limit; // mennyit szeretnenk lekérni (0..100)
Válasz adatok:
string PhotoName;
string PhotoThumb;
string PhotoURL;
string AlbumName;
int Visited;
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.getMostVisitedPhotos (string apikey, int t, int from, int limit) |
|
- Leglátogatottabb képek.
Szükséges adatok:
string apikey;
int t;
int from; // 0 .. 100 honnantól (maximum: 100)
int limit; // mennyit szeretnenk lekérni (0..100)
Válasz adatok:
string PhotoName;
string PhotoThumb;
string PhotoURL;
string AlbumName;
int Visited;
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.getMostVisitedAlbums (string apikey, int t, int from, int limit) |
|
- Leglátogatottabb albumok.
Szükséges adatok:
string apikey;
int t;
int from; // 0 .. 100 honnantól (maximum: 100)
int limit; // mennyit szeretnenk lekérni (0..100)
Válasz adatok:
string Owner;
string AlbumName;
string AlbumURL;
int PhotosNumber;
int Visited;
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.getRandomPhotos (string apikey, int t, int from, int limit) |
|
- Képek véletlenszerűen.
Szükséges adatok:
string apikey;
int t;
int from; // 0 .. 100 honnantól (maximum: 100)
int limit; // mennyit szeretnénk lekérni (0..100)
Válasz adatok:
string PhotoName;
string PhotoThumb;
string PhotoURL;
string AlbumName;
int Visited;
|
| 2008-02-17 18:58:24 |
|
| xfree.hu.getRandomAlbums (string apikey, int t, int from, int limit) |
|
- Albumok véletlenszerűen.
Szükséges adatok:
string apikey;
int t;
int from; // 0 .. 100 honnantól (maximum: 100)
int limit; // mennyit szeretnenk lekérni (0..100)
Válasz adatok:
string Owner;
string AlbumName;
string AlbumURL;
int PhotosNumber;
int Updated;
//timestamp
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.GetCategories (string apikey, int t) |
|
- Videótár kategóriák lekérdezése.
Szükséges adatok:
string apikey;
int t;
Válasz adatok:
int CategoryId;
string CategoryName;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.CountVideosByCategory (string apikey, int CategoryId, int t) |
|
- Videótár videóinak száma kategória szerint.
Szükséges adatok:
string apikey;
int CategoryId;
int t;
Válasz adatok:
int CategoryId;
string CategoryName;
int db;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.CountVideosByCategoryByUsername (string apikey, string username, int CategoryId, int t) |
|
- Adott felhasználó Videótárában lévő videók száma kategória szerint.
Szükséges adatok:
string apikey;
string username;
int CategoryId;
int t;
Válasz adatok:
string Username;
int CategoryId;
string CategoryName;
int db;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.GetCommentsForVideos (string apikey, string Video, int from, int limit, int t) |
|
- Adott videóhoz írt kommentek lekérdezése.
Szükséges adatok:
string apikey;
string Video; //videó azonosító
int from; //honnan kérjük? 0..150
int limit; // mennyit
int t;
Válasz adatok:
string Name;
int Date;
// timestamp
string CommentFull;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.GetMostVideosByCategory (string apikey, int CategoryId, string type, int from, int limit, int t) |
|
- Videótárban lévő videók listázása.
Szükséges adatok:
string apikey;
int CategoryId;// kategória azonosító
string type; // type = newest,most_viewed,most_voted,most_commented
int from; //honnan kérjük? 0..150
int limit; // mennyit
int t;
Válasz adatok:
int CategoryId;
int CategoryName;
string Username;
string Videotar;
string VideoName;
time VideoLength;
string VideoURL;
int Uploaded; //timestamp
int Views;
int Votes;
int Comments;
string Tags;
string Desc;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.GetMostVideosByCategoryByU (string apikey,string U,int CategoryId, string type,int from,int limit,int t) |
|
- Adott felhasználó Videótárában lévő videók listázása.
Szükséges adatok:
string apikey;
string U; // username
int CategoryId;// kategória azonosító
string type; // type = newest,most_viewed,most_voted,most_commented
int from; //honnan kérjük? 0..150
int limit; // mennyit
int t;
Válasz adatok:
int CategoryId;
int CategoryName;
string Username;
string Videotar;
string VideoName;
time VideoLength;
string VideoURL;
int Uploaded; //timestamp
int Views;
int Votes;
int Comments;
string Tags;
string Desc;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.GetVideosInfo (string apikey, string Video, int t) |
|
- Egy adott videó információinak lekérdezése.
Szükséges adatok:
string apikey;
string Video; // videó azonosító
int t;
Válasz adatok:
int CategoryId;
int CategoryName;
string Owner;
string Videotar;
string VideoURL;
int Uploaded; //timestamp
string VideoName;
time VideoLength;
int CategoryId;
string CategoryName;
int Views;
int Votes;
int Comments;
string Tags;
string Desc;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.GetRandom150 (string apikey, int from, int limit, int t) |
|
- Videók véletlenszerűen.
Szükséges adatok:
string apikey;
int from; // 0 .. 150 honnantól (maximum: 150)
int limit; // mennyit szeretnenk lekérni (0..150)
int t;
Válasz adatok:
int CategoryId;
int CategoryName;
string Username;
string Videotar;
string VideoName;
time VideoLength;
string VideoURL;
int Uploaded; //timestamp
int Views;
int Votes;
int Comments;
string Tags;
string Desc;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.SearchVideos (string apikey, string qk, string type, int from, int limit, int t) |
|
- Videó keresés.
Szükséges adatok:
string apikey;
string qk; // keresendő kucls, szó
string type; //type = newest,most_viewed,most_voted,most_commented
int from; // 0 .. 150 honnantól (maximum: 150)
int limit; // mennyit szeretnenk lekérni (0..150)
int t;
Válasz adatok:
int CategoryId;
int CategoryName;
string Username;
string Videotar;
string VideoName;
time VideoLength;
string VideoURL;
int Uploaded; //timestamp
int Views;
int Votes;
int Comments;
string Tags;
string Desc;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.SearchVideosByUsername (string apikey,string username,string qk,string type,int from,int limit,int t) |
|
- Videó keresés egy adott felhasználó videótárában.
Szükséges adatok:
string apikey;
string username;
string qk; // keresendő kucls, szó
string type; //type = newest,most_viewed,most_voted,most_commented
int from; // 0 .. 150 honnantól (maximum: 150)
int limit; // mennyit szeretnenk lekérni (0..150)
int t;
Válasz adatok:
int CategoryId;
int CategoryName;
string Username;
string Videotar;
string VideoName;
time VideoLength;
string VideoURL;
int Uploaded; //timestamp
int Views;
int Votes;
int Comments;
string Tags;
string Desc;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.UploadYoutubeVideoToMyVideos (string apikey, string youtubeURL, int t) |
|
- Youtube videó feltöltése a videótárba.
Szükséges adatok:
string apikey;
string youtubeURL;
int t;
Válasz adatok:
bool UploadReturnStatus; // true (1), false (0)
|
| 2008-02-17 18:58:24 |
|
| tv.xfree.hu.GetChannelList (string apikey, int t) |
|
- TV Műsor csatorna lista lekérdezése.
Szükséges adatok:
string apikey;
int t;
Válasz adatok:
int ChannelID;
string ChannelName;
|
| 2008-02-17 18:58:24 |
|
| tv.xfree.hu.GetMusorByChannel (string apikey, int/string Channel, string seach_key, int day, int t) |
|
- Adott csatorna műsor listájának lekérdezése.
Szükséges adatok:
string apikey;
int/string Channel; // csatorna azonosító vagy csatorna név
string search_key; // Keresendő kulcs,szó. keresés a műsor nevek között. Nem kötelező megadni.
int day; // day = 0, 1, 2 (0=Mai műsor, 1=Holnapi műsor, 2=Holnaputáni műsor)
int t;
Válasz adatok:
time Ido;
string MusorNev;
|
| 2008-02-17 18:58:24 |
|
| szotar.xfree.hu.Dictionary (string apikey, string s, int n, int p, int t) |
|
- Szótár.
Szükséges adatok:
string apikey;
string s; // fordítandó szó
int n; // 0..9
n = 0 : Angol -> Magyar
= 1 : Magyar -> Angol
= 2 : Nemet -> Magyar
= 3 : Magyar -> Nemet
= 4 : Francia -> Magyar
= 5 : Magyar -> Francia
= 6 : Latin -> Magyar
= 7 : Magyar -> Latin
= 8 : Olasz -> Magyar
= 9 : Magyar -> Olasz
int p; // 1..4
p = 1 : szó eleji egyezés
2 : szó végi egyezés
3 : teljes egyezés
4 : bármilyen egyezés
int t;
Válasz adatok:
string Nyelv1;
string Nyelv2;
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.UploadNewVideo (string apikey,int CategoryID,string VideoName,string Tags,string Desc, file V, int t) |
|
- Új Videó feltöltése a videótárba.
Szükséges adatok:
HTTP POST szükséges!!
string apikey;
int CategoryID;
string VideoName;
string Tags; // tags="hello,test,proba"
string Desc; // teljes leírás
file V; // videó fájl
int t;
Válasz adatok:
bool UploadReturnStatus; // true (1), false (0)
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.VotingAVideo (string apikey, string Video, int t) |
|
- Szavazás egy adott videóra.
Szükséges adatok:
string apikey;
string Video; // videó azonosító
int t;
Válasz adatok:
bool VoteReturnStatus; // true (1), false (0)
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.PostNewComment (string apikey, string Video, string NewComment, int t) |
|
- Új komment egy adott videóhoz.
Szükséges adatok:
HTTP POST szükséges!!
string apikey;
string Video; // videó azonosító
string NewComment; // komment
int t;
Válasz adatok:
bool CommentReturnStatus; // true (1), false (0)
|
| 2008-02-17 18:58:24 |
|
| video.xfree.hu.CopyVideoToMyVideos (string apikey, string Video, int t) |
|
- Egy adott Videótárban lévő videó másolása a saját Videótáramba.
Szükséges adatok:
string apikey;
string Video; // videó azonosító
int t;
Válasz adatok:
bool CopyReturnStatus; // true (1), false (0)
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.CheckNewMail (string apikey, int t) |
|
- Új email ellenőrzés.
Szükséges adatok:
string apikey;
int t;
Válasz adatok:
int NewMail;
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetNewMail (string apikey, int t) |
|
- Új levelek leszedése.
Szükséges adatok:
string apikey;
int t;
Válasz adatok:
string From; // feladó
string Subject; //téma,tárgy
DateTime Date; // dátum
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.InviteFriend (string apikey, string EmailAddressToInvite, int t) |
|
- TVN.HU Meghívó küldés.
Szükséges adatok:
string apikey;
string EmailAddressToInvite;
int t;
Válasz adatok:
bool InviteReturnStatus; // 0 = false, 1 = true
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.FriendsAreFriends (string apikey, string User1, string User2, int t) |
|
- User1 és User2 ismerik -e egymást?
Szükséges adatok:
string apikey;
string User1; // felhasználónév
string User2; // felhasználónév
int t;
Válasz adatok:
bool AreFriendsReturnStatus; // 0 = false, 1 = true
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetFriendsList (string apikey, string User, int t) |
|
- Egy adott felhasználó ismerősei.
Szükséges adatok:
string apikey;
string User; // felhasználónév
int t;
Válasz adatok:
string Username;
string Blog; // blog cím
string Keptar; // képtár cím
string Videotar; // videótár cím
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetMutualFriends (string apikey, string User1, string User2, int t) |
|
- Két adott felhasználó közös ismerősei.
Szükséges adatok:
string apikey;
string User1; // felhasználónév
string User2; // felhasználónév
int t;
Válasz adatok:
string Username;
string Blog; // blog cím
string Keptar; // képtár cím
string Videotar; // videótár cím
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetShortestPath (string apikey, string User1, string User2, int t) |
|
- A legrövidebb út két felhasználó között.
Szükséges adatok:
string apikey;
string User1; // felhasználónév
string User2; // felhasználónév
int t;
Válasz adatok:
string Username;
string Blog; // blog cím
string Keptar; // képtár cím
string Videotar; // videótár cím
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetMayBeFriends (string apikey, int t) |
|
- Kiket ismerhetek ?
Szükséges adatok:
string apikey;
int t;
Válasz adatok:
Lista
string Username;
string Blog; // blog cím
string Keptar; // képtár cím
string Videotar; // videótár cím
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetMayBeFriendsLinked (string apikey, int t) |
|
- Kiket ismerhetek láncolva?
Szükséges adatok:
string apikey;
int t;
Válasz adatok:
Lista
string Username;
string Blog; // blog cím
string Keptar; // képtár cím
string Videotar; // videótár cím
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.CountFriends (string apikey, string User, int t) |
|
- Egy adott felhasználó ismerőseinek száma.
Szükséges adatok:
string apikey;
string User;
int t;
Válasz adatok:
int FriendsNum; //ismerőseinek száma
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetUserRang (string apikey, string User, int t) |
|
- Egy adott felhasználó aktuális TVN Rangja.
Szükséges adatok:
string apikey;
string User;
int t;
Válasz adatok:
string Rang; // rang neve
string Csillag; // TVN rang jelképe
int Csillagdb; // hány darab csillag
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetUserBigfilesList (string apikey, string User, int t) |
|
- Adott felhasználó Bigfile listájának lekérdezése. Feltétel: Az adott felhasználó az ismerősöm.
Szükséges adatok:
string apikey;
string User; // felhasználónév
int t;
Válasz adatok:
Lista
string FileName;
int FileSize; // bytes
DateTime Uploaded; // feltöltés DateTime
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetUserIDCardPhoto (string apikey, string User, int t) |
|
- Egy adott felhasználó TVN.HU igazolványán szereplő kép lekérdezése.
Szükséges adatok:
string apikey;
string User;
int t;
Válasz adatok:
string PhotoURL; // kép URL
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.GetUserStatus (string apikey, string User, int t) |
|
- Egy adott felhasználó aktuális státusza (Online,Offline).
Szükséges adatok:
string apikey;
string User;
int t;
Válasz adatok:
bool UserStatus; // 1 == Online, 0 = Offline
|
| 2008-02-17 18:58:24 |
|
| tvn.hu.MarkUserAsFriend (string apikey, string MarkUser, int t) |
|
- Ismerősnek jelöljük az adott felhasználót.
Szükséges adatok:
string apikey;
string MarkUser; // őt jelöljük be ismerősnek
int t;
Válasz adatok:
bool MarkStatus; // 1 == Sikeres bejelölés, 0 = Sikertelen
|
| 2008-02-17 18:58:24 |
|
