UDP API DEV: Difference between revisions

{{TOCright}}

'''[[UDP_API_Definition|UDP API]] DEVELOPMENT'''

Feel free to edit / comment / whatever.

== Data Commands ==

=== [[UDP_API_Definition#GROUP:_Retrieve_Group_Data|GROUP]] ===

=== [[UDP_API_Definition#FILE:_Retrieve_File_Data|FILE]] ===

*FILE size={int8 size}&ed2k={str ed2khash}[&fcode={int4}&acode={int4}]

== Mylist Commands ==

=== MYLISTADD: Add file to mylist ===

Feature request: It'd be useful if the reply of this command would contain the lid of the added file.

== Notify Commands ==

== Misc Commands ==

=== ENCRYPT : Encrypt Command ===

This is a major modification of the UDP API encryption scheme which will break compatibility with

older clients. However, the current system has some weaknesses and only few clients support encryption so far.

* allow clients to recover from encryption failures without having to wait for the connection to timeout (resending ENCRYPT)

* prevent the server from unintentionally sending unencrypted data to a client, i.e. notifications. (no more dropping of encryption on decryption failure)

=== USERLIST : Retrieve Mylist Data of a specified user [<span style="color:red">rejected</span>] ===

:What I'm really interested in is maintaining local dbs of 3/4 user lists and having a client automatically update them every 2/3 weeks. We use this to coordinate information within our country regarding who has what =p. But what we're interested in is a way to be able to selectively retrieve the entire list by some index. Of course if its slow, then it makes sense to maintain it locally and just look for changes. The other thing I really want is to somehow retrieve with MyList file data (or user list file data), the date at which something was added to the list. (I understand this information exists). The idea here is we can locally query these lists for files added within the last 2/3 months. --[[User:path|path]] 11:53, 25 June 2006 (IST)

::That's really not wanted usage for this API. Have you thought about the possibility to use MyList export? You know you can make you own export template and get all the info you want at once? A command that query all changes (lids) within the last 2/3 months (or even weeks) is not going to be added. --[[User:Epoximator|Epoximator]] 12:36, 25 June 2006 (UTC)

== Other ==

=== Web Service API ===

I think most of the UDP API functionality could be exposed as a web service. Not only it would  make client programming simpler but could also solve some NAT/Proxy/Firewall UDP problems. This web service would only provide query capabilities, since callbacks (required for notifications) in web services still pose some problems. --[[User:Jassuncao|Jassuncao]] 08:43, 20 September 2006 (UTC)

::Since this is not the right place to start a flame war I will not comment.

=== HTTP/XML API===

[[Category:Development]]

[[Category:UDP]]

[[Category:API]]