Logs and usage
The API panel is at validades.com → Team → API, and only the owner and admins of the organization can access it.
Usage
- Month quota: how much was used, the total and when it resets. The bar turns yellow at 80% and red at 100%.
- Today: requests of the day (UTC).
- Limits: per key and per organization, per minute.
- Last 30 days: chart of requests per day.
- Most used routes: the 5 routes with the most requests, with the average response time.
Month and day numbers update right away. The history may take a few minutes to appear.
Request logs
The panel shows a summary of each request of the last 90 days:
| Column | What it shows |
|---|---|
| Date | date and time of the request |
| Route | method and route (for example PATCH /v1/batches/:id) |
| Status | HTTP code; the error code shows on hover |
| Key | name and last 4 characters of the key used |
| Duration | response time |
| IP | address the request came from |
| Request ID | the request_id; click to copy |
You can filter by result (success, client error, rate limited, denied, server error) and by key. Store cascade deletions are highlighted, with the number of products and batches deleted.
The panel does not show request bodies or headers. The Validades team has access to the full logs, for support and security, as described in the API Terms of Use.
Requests from an unknown IP or at odd hours may mean the key leaked. In that case, revoke the key right away. See Authentication.
Activity log
Changes made through the API also show up in the organization's activity log (Team → Logs) as "Via API (key "Name")", next to the changes made by members.
Emails
The owner and admins get an email when:
- API access is enabled, suspended, refused or ended;
- a new key is created;
- the organization uses 80% and 100% of the month's quota;
- a store is deleted through the API with
cascade=true; - there is a new version of the API Terms of Use to accept, a reminder 7 days before the deadline, and a notice if the API is blocked for lack of acceptance.