Authentication

Gere e envie o token Basic Auth para autenticar suas requisições na API da SharkHub.

Aprenda a gerar suas credenciais de autenticação e enviá-las nas requisições à API da SharkHub.

Basic OAuth

A API da SharkHub utiliza autenticação Basic Auth. Para autenticar, você precisa gerar um token Basic a partir das suas credenciais (public_key e secret_key).

Como gerar o token Basic

Concatene sua public_key e secret_key separadas por dois pontos (:) e codifique o resultado em Base64.

public_key:secret_key

pk_live_Bwjxd3eDUQDHWDKQ:sk_live_A1b2C3dEfGhIjKlM

Terminal (Linux/macOS)

echo -n "pk_live_Bwjxd3eDUQDHWDKQ:sk_live_A1b2C3dEfGhIjKlM" | base64

cGtfbGl2ZV9Cd2p4ZDNlRFVRREhXREtROnNrX2xpdmVfQTFiMkMzZEVmR2hJaktsTQ==

Python

import base64

public_key = "pk_live_Bwjxd3eDUQDHWDKQ"
secret_key = "sk_live_A1b2C3dEfGhIjKlM"
credentials = f"{public_key}:{secret_key}"
basic_token = base64.b64encode(credentials.encode()).decode()

print(basic_token)

TypeScript / Node.js

const publicKey = "pk_live_Bwjxd3eDUQDHWDKQ";
const secretKey = "sk_live_A1b2C3dEfGhIjKlM";
const credentials = `${publicKey}:${secretKey}`;
const basicToken = Buffer.from(credentials).toString("base64");

console.log(basicToken);

O valor gerado é o seu token Basic e deve ser utilizado em todas as requisições à API.

Requisições

Envie o token Basic no header Authorization, no formato Basic {token}.

curl --location 'https://staging.sharktecnologia.com/api/v1/user/company' \
  --header 'accept: application/json' \
  --header 'Authorization: Basic cGtfbGl2ZV9Cd2p4ZDNlRFVRREhXREtROnNrX2xpdmVfQTFiMkMzZEVmR2hJaktsTQ=='

Resposta esperada (`200 OK`)

{
  "api_active": true,
  "created_at": "2026-02-27T21:37:52.304116Z",
  "updated_at": "2026-02-27T21:37:52.304188Z"
}

Se o token estiver incorreto ou as credenciais forem de um ambiente diferente, a API retornará 401 Unauthorized.