Authentication API

This page describes how to authentication against Lenses APIs.

Basic Authentication

For Basic Auth, Lenses supports HTTP basic auth.

Starts a session given a username/password and puts it into a cookie.

POSThttps://api.example.com/api/v1/login

Body

application/json

username*string

password*string

Response

204

Happy response. A set-cookie header will be present.

Request

JavaScriptCurlPython

const response = await fetch('https://api.example.com/api/v1/login', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "username": "text",
      "password": "text"
    }),
});
const data = await response.json();

Service Accounts

The authenticate with service accounts, Lenses supports Bearer tokens. Set the token in the HTTP header request.

curl -L \
  -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer MY_SERVICE_ACCOUNT_TOKEN'
  'https://api.example.com/api/v1/login'