Primeira integração

Este guia leva você da conta v0x ao primeiro arquivo hospedado via API. Tempo estimado: 10 minutos.

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_.

Pré-requisitos

Conta Google para login em dash.v0x.lol
curl ou cliente HTTP no seu ambiente
Um arquivo de teste (PNG, PDF, etc.)

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

1. Criar conta

Acesse dash.v0x.lol/login
Clique em Continue with Google
Após o redirect, você estará em /dashboard

2. Criar uma API key

Abra API Keys
Clique em Create key
Dê um nome (ex. ShareX ou Worker Produção)
Copie o valor v0x_live_... — ele aparece uma única vez

3. Guardar a chave

# Linux / macOS
export V0X_API_KEY=v0x_live_SUA_CHAVE_AQUI

# Windows PowerShell
$env:V0X_API_KEY = "v0x_live_SUA_CHAVE_AQUI"

4. Testar health (sem auth)

curl https://api.v0x.lol/health

Resposta esperada:

{
  "status": "ok",
  "db": "ok",
  "storage": "ok"
}

5. Fazer upload

curl -X POST https://api.v0x.lol/api/v1/files \
  -H "Authorization: Bearer $V0X_API_KEY" \
  -F "file=@./screenshot.png"

Resposta 201:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "screenshot.png",
  "mime_type": "image/png",
  "size_bytes": 248103,
  "url": "https://cdn.v0x.lol/uploads/...",
  "created_at": "2026-09-15T23:00:00Z"
}

O campo url é o link direto público via CDN.

6. Listar arquivos

curl "https://api.v0x.lol/api/v1/files?page=1&limit=20" \
  -H "Authorization: Bearer $V0X_API_KEY"

7. Excluir arquivo

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

Começar

Integração

Integrações

Referência

Primeira integração

Pré-requisitos

Arquitetura correta

Onde armazenar

1. Criar conta

2. Criar uma API key

3. Guardar a chave

4. Testar health (sem auth)

5. Fazer upload

6. Listar arquivos

7. Excluir arquivo

Próximos passos

​Pré-requisitos

​Arquitetura correta

​Onde armazenar

​1. Criar conta

​2. Criar uma API key

​3. Guardar a chave

​4. Testar health (sem auth)

​5. Fazer upload

​6. Listar arquivos

​7. Excluir arquivo

​Próximos passos

Pré-requisitos

Arquitetura correta

Onde armazenar

1. Criar conta

2. Criar uma API key

3. Guardar a chave

4. Testar health (sem auth)

5. Fazer upload

6. Listar arquivos

7. Excluir arquivo

Próximos passos