Autenticação 🔐

Como autenticar suas requisições na Alauda API

Visão Geral

A Alauda API utiliza autenticação baseada em API Key via header HTTP. Cada requisição deve incluir sua chave no header X-API-Key.

Como Usar

Adicione o header X-API-Key em todas as suas requisições:

Exemplo com cURL

bash

curl -X POST https://api.alauda.mz/api/tiktok/download \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tiktok.com/@user/video/123"
  }'

Exemplo com JavaScript (fetch)

javascript

const response = await fetch('https://api.alauda.mz/api/tiktok/download', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://tiktok.com/@user/video/123'
  })
});

const data = await response.json();
console.log(data);

Exemplo com Python (requests)

python

import requests

headers = {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
}

data = {
    'url': 'https://tiktok.com/@user/video/123'
}

response = requests.post(
    'https://api.alauda.mz/api/tiktok/download',
    headers=headers,
    json=data
)

print(response.json())

Sistema de Créditos

Cada requisição consome créditos da sua conta. O consumo varia por tipo de operação:

Serviço	Custo (Créditos)
YouTube Info	10
YouTube Download	50
Spotify Search	10
Spotify Download	50
Instagram Download	50
TikTok Info	10
TikTok Download	30
Shazam Identify	100
Remove Background	10

Erros de Autenticação

Se houver problemas com a autenticação, você receberá uma das seguintes respostas:

401 Unauthorized

json

{
  "success": false,
  "error": "API key não fornecida"
}

Você não incluiu o header X-API-Key

401 Unauthorized

json

{
  "success": false,
  "error": "API key inválida"
}

A API Key fornecida não existe ou está incorreta

402 Payment Required

json

{
  "success": false,
  "error": "Créditos esgotados. Recarregue sua conta."
}

Sua conta não tem créditos suficientes para essa operação

403 Forbidden

json

{
  "success": false,
  "error": "API key expirada"
}

Sua API Key expirou. Renove sua conta

⚠️

Atenção

Mantenha sua API Key em segredo. Nunca a compartilhe publicamente ou faça commit em repositórios.

💡

Dica

Use variáveis de ambiente para armazenar sua API Key em produção. Nunca hardcode a key no código.