Authentication

Each API request requires an API key either as a HTTP Header or included as a query string.

You can find your API key in the Frill Dashboard.

Recommendation: It's best to use the HTTP Header - Bearer auth method - it's the easier than the Basic auth method and more secure than Query string

HTTP Header - Bearer auth

Include the API Key in the Authorization header where the value is prefixed with Bearer in the format:

GET https://api.frill.co/v1/ideas
Authorization: Bearer API_KEY

Query string

Include the API key as part of the request path in the format ?api_key=API_KEY.

GET https://api.frill.co/v1/ideas?api_key=API_KEY

HTTP Header - Basic auth

Following the Authorization Basic HTTP Spec. Provide your API key as the basic auth username value. You do not need to provide a password.

The Authorization field is constructed as follows:

  1. The username (api_key) and password (leave blank) are combined with a single colon. (:)

  2. The resulting string is encoded into an octet sequence.

  3. The resulting string is encoded using Base64.

  4. The authorization method and a space is then prepended to the encoded string, separated with a space (e.g. "Basic ").

GET https://api.frill.co/v1/ideas
Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l

Last updated