FAQ

Common Error Messages/Behavior for OAuth


Q: Why did I receive the following error message: The client you are attempting to give access to is not authorized by Slice. Please contact the developer?

A: This message indicates that you have not been confirmed as a valid user. Please check the redirect_uri parameter to ensure it’s set to the correct value (https://developers.google.com/oauthplayground for our ‘Quick Hello World’, or to your oauth callback URL).

Common Error Messages for White-Label


Q: Why does the link_mailbox URL send me to the Slice login page?

A: Your request token may not be URL safe. Try requesting another token by using api/v1/actions/login. If you still experience this behavior please contact us and the Slice API Team will resolve the situation.

Q: What’s the easiest way to debug my white-label code?

A: Simply download our command-line tool and use your credentials to populate the appropriate fields.

Q: I made a request to api/v1/actions/login and it didn’t seem to work. Are there any additional steps that I need to take?

A: To make the api/v1/actions/login request, you will need to have at least one user. Try linking mailboxes as they are added.

Syntax for different request methods


Q: What’s the syntax for making a PUT/POST/DELETE request for <Resource Name> ? I’ve tried sending as JSON and my changes don’t seem to go through?

A: We require using the query string body notation for all PUT/POST/DELETE requests on Resources. Additionally, please make sure to specify the Content-Type header as Content-Type: "application/x-www-form-urlencoded".

Q: Are there any sample requests available?

A: As a matter of fact, there are! Please refer to this chart:

Request method Example Slice CLT Request Body contents
POST POST /api/v1/orders “slicetestuser” orderDate 2010-02-22 orderTitle “Spotify Renewal” username=slicetestuser&orderDate=2010-02-22&orderTitle=”SpotifyRenewal”
PUT PUT /api/v1/orders/2812378237 “slicetestuser” orderDate 2016-02-25 username=slicetestuser&orderDate=2016-02-25
DELETE DELETE /api/v1/orders/2812378237 “slicetestuser” n/a


Syntax for Combining requests into one request


Q: I currently make separate calls to <Resource Name> and <Resource Name>. Is there any way to concatenate the information so that I can access the information through one request?

A: Yes, please use the expand URL query parameter along with the resource names(in a comma separated list).

Example: https://api.slice.com/api/v1/orders?expand=items,shipments

Syntax for Filtering through response data


Q: I have a very specific query for the Slice API, is it possible to sort or remove some of the extraneous response data?

A: Yes, it is. We’ve implemented some of the OData filter specification, and the supported features are as follows:

Feature Type Potential Values Example
Comparison Operators eq/ne/gt/ge/lt/le “price GT 500”
Member Fields <Resource Type>/<Field Name>/<Subfield(s) Name(s)> “order/merchant/name EQ ‘Target’”
Logical Operators and/or/not “price GT 500 AND order/merchant/name EQ ‘Target’”
Arithmetic Operators add/sub/mul/div/mod “price MOD 100 EQ 0”
String Functions concat/substring/trim/contains/indexof/startswith/endswith/toupper/tolower “CONTAINS(TOLOWER(merchant/name), ‘hotel’)”
Parentheses () “(price GT 5000) OR (price GT 1000 AND CONTAINS(description, ‘foo’))”


These strings should be called with the filter URL query parameter in the same manner as the expand parameter.

Syntax for Ordering response data


Q: I’d like to be able to view my results in a particular order. Would there be any way to ensure that?

A: You can sort the results returned from the Slice API by passing the orderBy URL query parameter. This parameter uses the same language as our filtering to display the API response in a particular way.

Example : https://api.slice.com/api/v1/orders?orderBy="purchaseDate desc, description asc, orderTax add ShippingCost"

Method to uniquely identify request


Q: I need to contact the Slice API Team, but I don’t have any way of identifiying the API request I’m experiencing issues with. Is there a way I can do so?

A: You can send the reqId URL parameter with a GUID for your Slice API requests. Then, simply include the reqId for the request you have questions about to our team, and we’ll take it from there!

Example : https://api.slice.com/api/v1/users/self?reqId=2dk23j-2383jvhb-12i3jgh3

SDK's

Listed below are our currently supported SDK’s. If you would like for us to support a release on a specific platform, feel free to contact us.

Sample Code

Check out our GitHub repository for some sample code!