OmniLink API
Accounts

Status da conta no cofre

`status` e `valid` se `encrypted_cookies` nao estiver vazio, senao `invalid`. Nao testa sessao na plataforma. `last_checked` e `account.updated_at` em ISO-8601.

GET
/v1/accounts/{platform}/status

status e valid se encrypted_cookies nao estiver vazio, senao invalid. Nao testa sessao na plataforma. last_checked e account.updated_at em ISO-8601.

Authorization

ApiKeyAuth
x-api-key<token>

Tenant key. Nao e JWT. Qualquer valor nao-vazio identifica um tenant via SHA-256. Ausencia => 401 API key ausente. Nao ha lista de chaves validas.

In: header

Path Parameters

platform*string

Plataforma. Valores aceitos pelo cofre (VaultService.SUPPORTED_PLATFORMS): amazon, mercadolivre, shopee. Comparacao case-insensitive (lower).

Value in

  • "amazon"
  • "mercadolivre"
  • "shopee"

Header Parameters

x-api-key*string

Identificador do tenant. Qualquer string nao-vazia e aceita; a API armazena apenas o SHA-256. Nao ha cadastro/validacao de chave. Chave diferente = tenant diferente (isolamento).

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/accounts/amazon/status" \  -H "x-api-key: sua-api-key"

{  "platform": "amazon",  "status": "valid",  "last_checked": "2026-08-15T22:00:00"}

Atualiza campos da conta existente PUT

Campos omitidos (null) nao sao alterados. `cookies: ""` cifra string vazia. Requer conta ja existente.

Enfileira geracao de links de afiliado POST

Cria uma task Celery `kind=affiliate` por URL (`urls` de 1 a 25). Resposta 202: `task_id`/`status_url` da primeira task e `task_ids` com todas. Requer conta no cofre. Shopee exige affiliate_id (App ID) e cookies (secret). `tag` default: `settings.default_affiliate_tag` (afiliadosLAB) se omitida. Worker: `run_affiliate_task`. Resultado posterior em GET /v1/tasks/{id}/status.