Request IDs

Every response from the API, success or error, carries an X-Request-Id header: a unique id for that request.

HTTP/1.1 200 OK
X-Request-Id: 4bf92f3577b34da6a3ce929d0e0e4736
RateLimit-Limit: 300
RateLimit-Remaining: 299
RateLimit-Reset: 51

• Log it next to your own request log, especially for writes and errors.
• Quote it when you write to hello@bizisy.com: with it we find the exact request in our logs, its timing and its outcome, without asking for anything else.

Request ids are not idempotency keys. To make a retry safe, send your own Idempotency-Key.

const res = await fetch('https://api.bizisy.com/v1/org/people.list', { method: 'POST', headers, body: '{}' });
if (!res.ok) {
  const { error } = await res.json();
  console.error(`${error.code}: ${error.message} (request ${res.headers.get('x-request-id')})`);
}