API do desenvolvedor

Com a API Seconda você pode postar anúncios de forma programática, sem abrir o site. Você precisa de uma chave API da sua conta.

1. Faça uma chave

As chaves são feitas a partir da sua conta, em Configurações, Chaves de API.

A chave é mostrada apenas uma vez, na criação. Copie-o então e mantenha-o seguro; você não pode ver depois disso.

2. Autenticar

Envie a chave com cada solicitação, em um dos dois cabeçalhos:

Authorization: Bearer seconda_ab12cd34_...

# sau, la fel de bine:
X-API-Key: seconda_ab12cd34_...

3. Crie um anúncio

Envie os dados do anúncio no formato JSON. O preço é inteiro, em dinheiro (15.000 significa 150,00 lei). São obrigatórios: título (5 a 80 caracteres), descrição (20 a 3.000 caracteres), categoria (um slug de categoria-folha) e preço (1 a 100.000 lei).

curl -X POST https://seconda.ro/api/v1/articole \
  -H "Authorization: Bearer CHEIA_TA" \
  -H "Content-Type: application/json" \
  -d '{
    "titlu": "Rochie de vara",
    "descriere": "Rochie usoara din bumbac, purtata de doua ori, marimea M.",
    "categorie": "femei-rochii",
    "pret": 15000,
    "moneda": "RON"
  }'

A resposta contém o ID do anúncio, que você precisará nas próximas etapas.

4. Carregue as imagens

Envie as imagens como multipartes, com o campo "fotos" repetido para cada arquivo. Entre 1 e 20 imagens, em formato JPEG, PNG ou WebP.

curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/poze \
  -H "Authorization: Bearer CHEIA_TA" \
  -F "[email protected]" \
  -F "[email protected]"

5. Publique o anúncio

Após adicionar as fotos, publique o anúncio para aparecer no catálogo.

curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/publica \
  -H "Authorization: Bearer CHEIA_TA"

E-mails de confirmação

Ao postar manualmente, no site, você recebe um e-mail de confirmação para cada anúncio. Ao postar pela API, com uma chave, você não recebe um email com cada anúncio, mas sim um único resumo no final do dia.

Cookies na Seconda