upload.checkTickets
Live testing
Check the status of one or more upload tickets.
Do not poll this method more than necessary, according to the "eta" value.
- This method call must be authenticated and signed.
- This method requires "write" permission on docs.
URL
https://api.ipernity.com/api/upload.checkTickets
Parameters
api_key
|
∗ | Your api_key. |
tickets
|
∗ | A comma delimited list of upload tickets. (A list of 50 tickets is a maximum). |
Response
<tickets count="4" done="2" invalid="1" left="1" eta="120"> <ticket id="712218" done="1" invalid="0" doc_id="5412" eta="0"/> <ticket id="712219" done="0" invalid="1" eta="0"/> <ticket id="712310" done="1" invalid="0" doc_id="1235" eta="0"/> <ticket id="712311" done="0" invalid="0" eta="120"/> </tickets>
The global eta
(estimated time of arrival) value represents the number of seconds left to complete the tickets. Each ticket has it's own eta
. Please do not query unecessary tickets such as done tickets or before it's eta is supposed to be 0.
Once the tickets have been processed, you may redirect to the following url : https://www.ipernity.com/doc/(user_id)/uploaded?doc_id1,doc_id2,doc_id3,...
Error codes
1 | Some or all the tickets sent were not found. | |
100 | Please add the api_key parameter to this request. | |
101 | This API key is invalid or disabled. | |
102 | The requested format is invalid. Valid formats are : json, xml, php. | |
103 | The requested method is invalid or missing. | |
104 | The query signature is missing. | |
105 | The query signature is invalid. | |
106 | User is not logged. The authentication token is missing. | |
107 | The authentication token is invalid. | |
108 | The user account is closed or suspended. | |
109 | This action is blocked because of a member or a group blocklist restriction | |
110 | Insufficient permissions for this method. | |
111 | The request came from a remote address not allowed by this application. | |
112 | The application has reached its requests quota. | |
113 | The client IP has reached a limit. Limits are based on requests per seconds, minutes, hours, ... | |
120 | This API method must be called using HTTP POST. | |
121 | The SOAP envelope could not be parsed. | |
122 | The XML-RPC envelope could not be parsed. | |
130 | We only support OAuth version 1.1 and 1.1a | |
131 | Some of the OAuth parameters were not sent: %s% | |
132 | The timestamp sent is out of ranges. Please check your computer clock is not skewed. | |
133 | The OAuth Nonce parameter cannot be used twice. | |
134 | The OAuth Timestamp parameter is out of ranges (clock skew) or inferior to the previous timestamp sent. | |
135 | The OAuth Signature must be either MD5, HMAC_SHA1 or PLAINTEXT over HTTPS. | |
500 | Service general error. | |
501 | Service under temporarily maintenance. Thank you for your kind understanding. | |
503 | The service is temporarily unavailable. Please try again in a few minutes. |
Changelog
- 2008-12-01: Method created.
See also
Jump to top
- ipernity © 2007-2024
- Help & Contact
|
Club news
|
About ipernity
|
History |
ipernity Club & Prices |
Guide of good conduct
Donate | Group guidelines | Privacy policy | Terms of use | Statutes | In memoria -
Facebook
Twitter