Getting started

📘

This API works for both apps ArchiSnapper.com and SafetySnapper.com - it is 100% the same API, only the endpoint URL is different

📘

If you notice the docs are out of date or are unclear, please don't be shy about clicking the "Suggest Edits" link! We're working to keep these docs up to date, however sometimes we get behind – and we'd love your help.

Authentication

Authentication requires a key. You will need to include your key in ever request. Please ask your key to [email protected] if you don't have your key yet.

The key can be passed via query param as GET...

/api/public/v1/sites.json?auth_token=YOUR_KEY

...or you can include it in the data being POSTed

{"auth_token"=>"YOUR_KEY", ... }

If you don't pass a key, you will get an error

API endpoint

The full API endpoint is

https://app3.archisnapper.com/api/public/v1/

or if you are using SafetySnapper, use this endpoint

https://app3.safetysnapper.com/api/public/v1/

API rate limits

We apply the following rate limits for our API:

  • max 100 requests per minute
  • max 10.000 requests per day

About our different ID's (for projects).

We have 4 different ID's which you can work with in (most) of our API endpoints

  • id is our own internal ID, created and managed by us. You will see it and you can use it in most API calls.
  • uuid is our own internal UUID, created and managed by us. You will see it and you can use it in most API calls.
  • unique_id is your project number. It has to be unique. It can be changed online by end users working with ArchiSnapper.
  • client_internal_unique_id is your own internal ID. It is not mandatory to use within ArchiSnapper. If you use it, it has to be unique. It can not be changed by end users working with ArchiSnapper, it can only be set and changed by this API. If you use this, you can be sure that it will never be changed (unless you change it via API calls).