Note: Requests must be made to https://api.flipsnack.com/v1.
Name | Type | Description |
apiKey (required) | string | The API key provided for your user. If it is not specified, the request will return the error code "30 - Missing mandatory parameter". If the key is incorrect the request returns the error code "41 - Invalid credentials". |
signature (required) | string | The signature must be calculated by you and added to the request. See How to sign a request for more information. If the parameter is missing the request will return the error code "30 - Missing mandatory parameter". If the signature is incorrect the request will return the error code "44 - Invalid signature". |
action (required) | string | The API method that should be called. In this case the value should be collection.deleteLogo. If it is not specified, the request will return the error code "30 - Missing mandatory parameter". |
collectionHash (required) | string | The hash of the collection from which the logo image will be removed. If it is not specified, the request will return the error code "30 - Missing authentication". |
format | string | The format of the response from the server. Possible values are json, jsonp and xml. If you set format to jsonp, you must also specify the callback parameter. Default: json. |
callback | string | The name of the callback function used for the jsonp response. This parameter is required if format is set to jsonp. Otherwise it is ignored. |
If the request is successful, the API call returns information about the specified collection.
This action method has the same response as collection.getCollection method.
Code | Message | Explanation |
30 | Missing mandatory parameter | The request does not contain one or more required parameters. There are at least 3 required parameters for every request: apiKey, signature and action. Other methods may also have extra mandatory parameters. Please check the API Reference for more information. |
31 | Requests per second limit exceeded | There were too many requests per second made with the same API key. |
32 | Requests per minute limit exceeded | There were too many requests per minute made with the same API key. |
40 | Bad request |
|
41 | Invalid credentials | The API key provided in the request is invalid. |
42 | Invalid action | The API method you specified in the request is incorrect. Please see the API Reference for the list of possible methods. |
43 | Forbidden | You are not allowed to access the specified collection: it has been deleted or the collection belongs to another user. |
44 | Invalid signature | The signature you provided is incorrect - it does not match the request. |
46 | Invalid collection hash | You are trying to access a collection that does not exist. |
<form method="get" action="https://api.flipsnack.com/v1/"><input type="hidden" name="action" value="collection.deleteLogo"><input type="hidden" name="apiKey" value="LK12NS-0-IOBW3S89VVJH12Z"><input type="text" name="collectionHash"><button type="submit">Submit</button></form>
curl -F "action=collection.deleteLogo"\-F "apiKey=LK12NS-0-IOBW3S89VVJH12Z"\-F "collectionHash=d3m0h45h"\-F "signature=2298a6456c1dd2d12b895ce4688ffe31"\https://api.flipsnack.com/v1/
<?xml version="1.0" encoding="utf-8"?><response><code>20</code><status>OK</status><data><collectionHash>d3m0h45h</collectionHash><collectionTitle>Lorem ipsum</collectionTitle><collectionStatus>published</collectionStatus><collectionItems><collectionItem><flipbookHash>7c5e600d4459fe4e04d23ae5ei188777</flipbookHash><flipbookTitle>Lorem ipsum</flipbookTitle></collectionItem></collectionItems><settings><logoImage></logoImage><logoUrl></logoUrl></settings></data></response>
{"code": 20,"status": "OK","data": {"collectionHash": "d3m0h45h","collectionTitle": "Lorem ipsum","collectionStatus": "published","collectionItems": [{"flipbookHash": "7c5e600d4459fe4e04d23ae5ei188777","flipbookTitle": "Lorem ipsum"}],"settings": {"logoImage": "","logoUrl": ""}}}
callbackFunctionName({data});// callbackFunctionName is the function name specified by the callback parameter, in the request// the {data} is the actual JSON response