PND repository specification - Revision history

Kingu: removed proposal link, that is a category

2013-10-25T20:11:06Z

removed proposal link, that is a category

2012-05-14T23:27:08Z

2012-05-14T23:24:34Z

‎Client Repository Communication API

2012-05-14T23:22:56Z

‎Client Repository Communication API

2012-05-14T23:21:05Z

‎Client Repository Communication API

2012-05-14T23:20:13Z

‎History of Downloads

2012-05-14T23:19:47Z

‎History of Downloads

2012-05-14T23:19:21Z

‎History of Downloads

2012-05-14T23:16:54Z

‎History of Downloads

2012-05-14T23:16:12Z

‎History of Downloads

@@ Line 197: / Line 197: @@
+}
 </source>
 [[Category:PND]]
 [[Category:Ideas and proposals]]
 [[Category:Community]]

@@ Line 10: / Line 10: @@
 = Client implementations =
 Clients should store lists of URIs to repository files and download files from these URIs on demand, respecting cache metadata. They may use HEAD requests on HTTP repository URIs to get information about expiry times that the repository files may have. It should NOT be possible to perform head operations on actual downloadable files, however; repository URI references should be immutable, and a tracked URI must always point to the same data.
 = Format =

@@ Line 12: / Line 12: @@
 = Client <--> Repository Communication API =
-A Client can do more than just download the list of available applications from a given PND repository, So long as that repository provides the correct API interface and also provides.
+A Client can do more than just download the list of available applications from a given PND repository, So long as that repository provides the correct API interface.
 ''All data is sent to the server via [http://en.wikipedia.org/wiki/POST_(HTTP) POST] apart from when downloading an application which uses URL Parameters via [http://en.wikipedia.org/wiki/GET_(HTTP)#Request_methods GET]''

@@ Line 68: / Line 68: @@
 the "id" (application id) parameter should be the ID of the application we are assigning the comment to.
-''These parameters should be transferred in the URL via the [http://en.wikipedia.org/wiki/POST_(HTTP) POST] method''
+''These parameters should be transferred via the [http://en.wikipedia.org/wiki/POST_(HTTP) POST] method''
 === Comment Submission ===
@@ Line 75: / Line 75: @@
 the "id" (application id) parameter should be the ID of the application we are assigning the rating to.
-''These parameters should be transferred in the URL via the [http://en.wikipedia.org/wiki/POST_(HTTP) POST] method''
+''These parameters should be transferred via the [http://en.wikipedia.org/wiki/POST_(HTTP) POST] method''
 === Download logging / Purchased App Download ===

@@ Line 67: / Line 67: @@
 The "r" (rating) parameter can be a string of up to 300 characters.
 the "id" (application id) parameter should be the ID of the application we are assigning the comment to.
 ''These parameters should be transferred in the URL via the [http://en.wikipedia.org/wiki/POST_(HTTP) POST] method''
@@ Line 73: / Line 74: @@
 The "c" (comment) parameter can only be a number between 1 and 5.
 the "id" (application id) parameter should be the ID of the application we are assigning the rating to.
 ''These parameters should be transferred in the URL via the [http://en.wikipedia.org/wiki/POST_(HTTP) POST] method''
@@ Line 79: / Line 81: @@
 The "id" (application id) parameter should be the ID of the application you wish to download.
 The "a" (anonymous) parameter should be sent with the string value of "false" if you wish to authorise download log or purchased download.
 ''These parameters should be transferred in the URL via the [http://en.wikipedia.org/wiki/GET_(HTTP)#Request_methods GET] method''

@@ Line 108: / Line 108: @@
            "type":"release"//(type: json-string, "alpha", "beta", or "release")
          },
-         //OPTIONAL: The Unix time at which the PND was added/modified. (type: int)
+         //OPTIONAL: The Unix time at which the PND was downloaded. (type: int)
          "download_date":1335105932
+       }

@@ Line 91: / Line 91: @@
 //Unicode characters are escaped with "\uXXXX" as per the JSON standard.
+{
-   //Information about the repository. (type: json-object)
+   //Information about the users download history. (type: json-object)
    "history":{
      //Username of user(type: json-string)

@@ Line 86: / Line 86: @@
 <source lang="javascript">
+{
    "history":{
      "user":"milkshake",
      //Information about the PND packages downloaded. (type: json-array)

@@ Line 91: / Line 91: @@
      "packages":[
+       {
          "id":"sd-install-2011-03-10",
          //OPTIONAL: The Package version at the time of download. (type: json-object)