Skip to content

The API log

2 min read

The log answers one question, and in daily operation it comes up constantly: is anything arriving from this source, and with what result? It sits as the fourth tab of the API area and shows the last twenty-five calls with time, method, path, status and duration.

What was in it is not in here

What gets recorded is that and how a request ran, not what it contained. Case data arrives through the API, and case data does not belong in a log that is read for troubleshooting. Whoever needs the content looks at the record, where it sits under permissions instead of in a list without any.

The colour says where to look

Green means accepted. Amber means refused, and the kind of error stands beside it, an unknown entity for instance, or a field strict mode would not let through. Red means it was on the platform. The refused value itself is never written down, only its kind.

The token in the path is shortened

A call through a source token carries the access in the address. It is replaced before storing, and three asterisks stand in its place in the log. Otherwise a working access would sit in a list anyone with read permission can open.

The same count also puts on the brakes

The log doubles as the counter for rate limiting. How many calls came in during the last minute is read off here rather than kept in a second table, which saves one write per call for the same statement.

Why does my test record appear in the log without a key?

Because the button in the documentation takes the same path as an ad, only without an access. Attributing an invented key to it would mean claiming an access that never existed.

The source says it sent something and nothing is here.

Then the request never arrived. Check the address first: a typo in the token cannot be assigned to any account, and what cannot be assigned to an account appears in no account's log.

Can I filter for errors?

Not in this view. It shows the last twenty-five calls as a list; refused ones are marked amber, with the error name beside them.

Can I see what became of a call?

The entry remembers which record came out of it. What happened to that record afterwards is in its own history, not here.