OmniLink API
Affiliate

Enfileira geracao de links de afiliado

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.

POST
/v1/affiliate/{platform}/generate-link

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.

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

application/json

curl -X POST "https://example.com/v1/affiliate/amazon/generate-link" \  -H "x-api-key: sua-api-key" \  -H "Content-Type: application/json" \  -d '{    "urls": [      "https://produto.mercadolivre.com.br/MLB-123",      "https://produto.mercadolivre.com.br/MLB-456"    ],    "tag": "afiliadosLAB",    "webhook_override": "https://seusistema.com/hook-task"  }'
Empty

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.

Resolve URL canonica e gera link de afiliado POST

Mesmo body e regras de conta que generate-link. Cria tasks `kind=affiliate_convert` (`run_affiliate_convert_task`): resolve short/social/afiliado para URL canonica e gera o link com a tag da conta. Nao altera generate-link.