Basic Authentication Overview - Calven Developer Docs

To allow systems that cannot support a two-step auth process to report presence, the /basic endpoints accept basic authentication.

A specific API key that is enabled for basic authentication is required. This API key cannot be used with the /v1/auth endpoints.

Contact Calven support to request a basic auth API key.

Basic authentication sends a header holding the username and password, joined by a colon and encoded as base64:

Authorization: Basic base64({userName}:{password})

On Calven endpoints, use the apiKeyId as the username and the apiSecret as the password. Join them with a colon, encode the result as base64, and send:

Authorization: Basic base64({apiKeyId}:{apiSecret})

An apiKeyId of abc123 and an apiSecret of s3cret encode to YWJjMTIzOnMzY3JldA==, so the header reads:

Authorization: Basic YWJjMTIzOnMzY3JldA==

Most HTTP clients build this header for you. In curl, pass the pair to -u and curl encodes it: