Chaves de API

Chaves de API autenticam integrações server-to-server, ShareX e scripts CLI. Não usam sessão do dashboard.

Base URL

https://api.v0x.lol/api/v1

Desenvolvimento local: http://localhost:8080/api/v1Health check (sem prefixo /api/v1): GET https://api.v0x.lol/healthChaves de produção usam o prefixo v0x_live_.

Tutorial visual: Criar chave de API. Fluxo completo: Primeira integração.

API keys são credenciais secretasTrate v0x_live_... como senha de banco de dados. Qualquer pessoa com a chave pode fazer upload e consumir sua quota de storage.Nunca:

commite no Git (.env no .gitignore)
coloque em código frontend (React, Vue, Svelte)
envie em apps mobile sem proxy backend
armazene em localStorage, sessionStorage ou cookies do browser
exponha em URLs, query strings ou repositórios públicos

Arquitetura correta

Browser / App / ShareX
      ↓
Backend do cliente (seu servidor) — opcional para ShareX direto
      ↓  Authorization: Bearer v0x_live_...
v0x API

Para integrações web, o usuário final faz login via Google no dashboard. Scripts e ShareX usam API key server-side ou localmente no cliente desktop.

Onde armazenar

Ambiente	Recomendação
Servidor Node/Python/Go	`process.env.V0X_API_KEY` / `os.environ`
Docker / K8s	Secret do orchestrator
CI/CD	Secret do pipeline (GitHub Actions, etc.)
ShareX	Campo `Authorization` no `.sxcu` (máquina local)

Veja também: Chaves de API · Boas práticas

Formato

Campo	Valor
Prefixo	`v0x_live_`
Exemplo	`v0x_live_abc123...`

O secret completo aparece uma vez na criação. O servidor armazena apenas o hash.

Criar a chave

Dashboard → API Keys

export V0X_API_KEY=v0x_live_SUA_CHAVE

Enviar na requisição

curl https://api.v0x.lol/api/v1/files \
  -H "Authorization: Bearer $V0X_API_KEY"

Em código backend:

const apiKey = process.env.V0X_API_KEY;

import os
api_key = os.environ["V0X_API_KEY"]

Erros de autenticação

Código	HTTP	Causa
`unauthorized`	401	Header ausente, chave inválida ou revogada

Rotacionar chave

Crie nova chave no dashboard
Atualize variáveis de ambiente nos serviços
Teste upload + listagem
Revogue a chave antiga

Boas práticas

Uma chave por ambiente/serviço
Nunca exponha em frontend ou repositórios
Mascare em logs: v0x_live_...abc1
Revogue chaves comprometidas imediatamente

Começar

Integração

Integrações

Referência

Arquitetura correta

Onde armazenar

Formato

Criar a chave

Enviar na requisição

Erros de autenticação

Rotacionar chave

Boas práticas

​Arquitetura correta

​Onde armazenar

​Formato

​Criar a chave

​Enviar na requisição

​Erros de autenticação

​Rotacionar chave

​Boas práticas

Arquitetura correta

Onde armazenar

Formato

Criar a chave

Enviar na requisição

Erros de autenticação

Rotacionar chave

Boas práticas