Skip to main content

Best practices

Here are some best practice and tips & tricks you can use to get the best of Altoviz API.

Updating the right way​

You might think that to update a entity, you just have to call the corresponding update API and that's all.
Be careful ! This will override all entity values with the new ones including the fact that none provided values will get default values.

So, the good practice is to :

  1. get the entity values from the server
  2. update the entity with new values
  3. post the updated entity to the server

Stop polling and use webhooks​

Polling servers is something you should avoid at much as possible. It's good for nobody. It consumes precious resources unnecessarily.
Instead of sending requests in a loop, just setup a webhook. You'll get notified when needed. The planet and our servers will you 🌳.
Read more

Check webhooks calling IPs​

You should verify that the servers calling your URL is part of the IP pool of Altoviz API.
Read more

Check the Altoviz certificate​

You might want to very that the server you're sending data to is one of Altoviz servers. Use the Altoviz public key for that.
Read more