Help / API

upload.replace / Live testing

Replace a file.

  • This method call must be authenticated and signed.
  • This method requires "write" permission on docs.

URL

HTTP POSThttp://www.ipernity.com/api/upload.replace

Parameters

api_key ∗ Your api_key.
file ∗ The file data. Use a url-encoded post. Do not include this parameter when signing the query.
doc_id The document ID to be replaced with this file.
∗ : this parameter is required.

Response

<ticket>12345445-98829</ticket>
Once the upload is complete, use the upload.checkTickets method to check when the documents have been processed.

Error codes

1 File is missing or empty We could not find the file data.
2 File size exeeded limits The file size exeeded the acceptable size limits. See user.getQuota for more details.
3 User exeeded upload limits The user has uploaded too much this month. See user.getQuota for more details.
4 Document not found The document ID is invalid or insufficient permissions to view this doc.
5 File media type differs from the existing file When replacing a file, the new file media type must match the existing file media type. (e.g. you may replace a photo by a photo, a video by a video, etc...)
6 PRO account feature The calling user does not hav a PRO account.
100 API Key is missing Please add the api_key parameter to this request.
101 API Key is invalid This API key is invalid or disabled.
102 Invalid format The requested format is invalid. Valid formats are : json, xml, php.
103 Method not found The requested method is invalid or missing.
104 Signature missing The query signature is missing.
105 Signature is invalid The query signature is invalid.
106 Token missing User is not logged. The authentication token is missing.
107 Token invalid The authentication token is invalid.
108 Account closed The user account is closed or suspended.
109 Action blocked This action is blocked because of a member or a group blocklist restriction
110 Insufficient permissions Insufficient permissions for this method.
111 IP not allowed The request came from a remote address not allowed by this application.
112 Application Quota Error The application has reached its requests quota.
113 Client IP Quota Error The client IP has reached a limit. Limits are based on requests per seconds, minutes, hours, ...
120 HTTP POST required This API method must be called using HTTP POST.
121 Invalid SOAP envelope The SOAP envelope could not be parsed.
122 Invalid XML-RPC envelope The XML-RPC envelope could not be parsed.
500 Service error Service general error.
501 Maintenance mode Service under temporarily maintenance. Thank you for your kind understanding.
503 Service unavailable The service is temporarily unavailable. Please try again in a few minutes.

Changelog

  • 2008-12-01: Method created.

See also



 

Català | Čeština nové | 中文 | Deutsch | English | Español | Esperanto | Ελληνικά | Français | Galego | Italiano | Nederlands | Português | More...