Client Repository Communication API - Revision history

Kingu: merged Repository with delta transfers

2013-10-26T14:16:45Z

merged Repository with delta transfers

2013-10-25T20:07:53Z

removed proposal link page, that is a category

2013-03-21T20:07:08Z

‎Handshake

2012-07-09T20:15:26Z

‎Rating Submission

2012-07-09T20:09:54Z

‎Rating Retrieval

2012-07-09T20:08:04Z

‎Rating Submission

2012-07-09T20:05:52Z

‎Rating Submission

2012-07-09T20:03:14Z

‎Rating Submission

2012-06-01T17:32:32Z

Make versions constat

2012-05-28T18:21:26Z

‎List of archived applications

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

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

@@ Line 35: / Line 35: @@
 which works like this md5(NONCE+CNONCE+APIKEY). So the following gets posted
 back to the server:
-stage=2&user=<username>&hash=md5(NONCE+CNONCE+APIKEY)
+cnonce=<CNONCE>&stage=2&user=<username>&hash=md5(NONCE+CNONCE+APIKEY)
 //<--------- as long as the session on the server is still active, the server pulls up the

@@ Line 94: / Line 94: @@
 ''These parameters should be transferred via the [http://en.wikipedia.org/wiki/POST_(HTTP) POST] method''
-Upon successful rating submission the server will return the new overall rating for that application, along with the rating type "final" or "non final" depending on if the application has had 4 or more application ratings submitted.
+Upon successful rating submission the server will return the new overall rating for that application.
 Here is an example of what this returned JSON output would look like:
 <source lang="javascript">
-{"success":{"number": 3,"text":"Your rating has been updated.","new rating":96,"type":"final"}}
+{"success":{"number": 3,"text":"Your rating has been updated.","new rating":96}}
 </source>

@@ Line 78: / Line 78: @@
 *The "id" (application id) parameter should be the ID of the application we are assigning the comment to.
 ''These parameters should be transferred via the [http://en.wikipedia.org/wiki/POST_(HTTP) POST] method''
 == Rating Submission ==

← Older revision		Revision as of 20:08, 9 July 2012
Line 89:		Line 89:

	Upon successful rating submission the server will return the new overall rating for that application, along with the rating type "final" or "non final" depending on if the application has had 4 or more application ratings submitted.		Upon successful rating submission the server will return the new overall rating for that application, along with the rating type "final" or "non final" depending on if the application has had 4 or more application ratings submitted.
		+
		+	Here is an example of what this returned JSON output would look like:
		+
		+	<source lang="javascript">
		+	{"success":{"number": 3,"text":"Your rating has been updated.","new rating":96,"type":"final"}}
		+	</source>

	== Comment Submission ==		== Comment Submission ==

@@ Line 70: / Line 70: @@
 A session may only last 15 seconds after a successful handshake meaning if no action is requested within those 15 seconds the session is destroyed and again any further actions will require a fresh handshake.
 == Rating Submission ==
 ''Current Repo Rate URI is [http://repo.openpandora.org/client/rate http://repo.openpandora.org/client/rate]''
-After a successful handshake 2 parameters will need to be POSTED to the appropriate server API URL:
+After a successful handshake 3 parameters will need to be POSTED to the appropriate server API URL:
 *The "r" (rating) 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 comment to.

@@ Line 107: / Line 107: @@
      "versions":[
+     {
-         //Version number of the app. (type: json-string)
+         //Package version at the time of comment. (type: json-object)
-         "version":"1.8.6.2",
+         "version":{
          //All Comments for this (version number above) version of the app. (type: json-array)
          "comments":[
@@ Line 161: / Line 167: @@
              "release":"1",      //(type: json-string, with characters 0-9, a-z, A-Z, +, -)
              "build":"1",        //(type: json-string, with characters 0-9, a-z, A-Z, +, -)
-             "type":"release"    //(type: json-string, "alpha", "beta", or "release")
+             "type":"release"    //(type: json-string, "alpha", "beta", or "release") OPTIONAL
          },
          //OPTIONAL: The Unix time at which the PND was downloaded. (type: int)
@@ Line 194: / Line 200: @@
+     {
          //The Package version of the archived application. (type: json-object)
-        "version":"0.1.270.0",
+       "version":{
          //The Unix time at which the PND was downloaded. (type: int)
          "date":1313502307

@@ Line 175: / Line 175: @@
 To retrieve a list of archived PND's for a specific app you can do this without the need to perform the handshake as no user details are required. 1 parameters will need to be POSTED to the appropriate server API URL:
-*The "id" (application id) parameter should be the ID of the application we are assigning the rating to.
+*The "id" (application id) parameter should be the ID of the application from which you would like to see the archived versions.
 ''These parameters should be transferred via the [http://en.wikipedia.org/wiki/POST_(HTTP) POST] method''