Are API keys Business wide or specific to users?

We have made them specific to each user for security reasons. Business owners need accountability and compliance that ensures all API access can be pin-pointed to a specific API user access.

How do I get an API Key

1. While signed into your Saasu file Click on My Saasu in the top menu.
2. Click on your Subscription e.g. Subscription: SampleCo
3. Click on the pencil icon next to the user you want to give an API access key to.
4. In this Edit User screen tick the check box “This user has permission to connect via web services key”.
5. Click save to reveal the user specific API key.

Why am I getting a list of all entities when I try to retrieve a single entity (e.g. Contact, Invoice)?

Make sure you’re sending the request to the right URL. Most likely, you sent the request to “GET List” instead of “GET “. Example: To retrieve a single contact, the query should be sent to:

https://.../webservices/rest/r1/Contact?wsaccesskey={YourWSAccessKey}&fileuid={YourFileUid}&uid={ContactUid}

Note that it’s “Contact” not “ContactList”. To retrieve a list of contacts matching certain criteria, make a GET request to ContactList, passing the supported criteria through query string.

If you are using our .NET RestClient Wrapper to make the call, you need to use the “GetByUid” method instead of the “Find” method.

// To retrieve a single contact:
CrudProxy proxy = new ContactProxy();
ContactDto jim = (ContactDto) proxy.GetByUid(99999);

For more info, see the brief introduction to Saasu .NET RestClient and download the Saasu .NET REST Client and Sample Application. The NUnitTest project contains lots of sample usage.