OmniLink API
Accounts

Atualiza campos da conta existente

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

PUT
/v1/accounts/{platform}

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

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/accounts/amazon" \  -H "x-api-key: sua-api-key" \  -H "Content-Type: application/json" \  -d '{    "affiliate_id": "af-999",    "csrf_token": "token-atualizado",    "cookies": "session=novo-cookie",    "webhook_url": "https://seusistema.com/novo-webhook"  }'
{  "platform": "amazon",  "affiliate_id": "af-999",  "webhook_url": "https://seusistema.com/novo-webhook"}

Cria ou atualiza conta no cofre (upsert) POST

Upsert por (`api_key_hash`, `platform`). Cookies e csrf_token sao cifrados com Fernet. Plataformas: amazon, mercadolivre, shopee. Shopee: `affiliate_id` = App ID da Open API; `cookies` = secret (nao e cookie de navegador). Status HTTP 201 mesmo em update de conta existente (o handler usa status_code=201 no POST).

Status da conta no cofre GET

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