API
API Overview
What the Hygiara API is for and how to think about it before you automate against it.
What this page is for
This page explains the intent of the API and the kind of automation it is best suited for.
When to use it
Use it when:
- you are planning an integration
- you want to know whether the API is the right tool instead of the UI
- you need a simple mental model before reading endpoint-specific guidance
What the API is for
The API is there for automation and integration, not as a second copy of the product UI.
It is most useful when you want to:
- create reviews programmatically
- check review state from another system
- retrieve report output in an automated workflow
How to approach it
Start with the smallest useful integration:
- create a review
- poll for status
- retrieve the output you need
What to expect
API access is authenticated with organization API keys, so treat those keys as operational credentials.
Common mistakes
- trying to automate everything at once
- treating the API like a replacement for learning the product workflow
- using poorly managed API keys for production integrations