MarketCity API v1.0.0
FastAPI API Portal

Portal do Desenvolvedor &
Documentação de Integração

Bem-vindo à API oficial do MarketCity. Aqui você encontra todas as rotas necessárias para gerenciar vitrines multi-tenant, cadastrar produtos de forma manual e realizar a ingestão automatizada via API com conversão inteligente de links de afiliados.

Swagger UI

Documentação Interativa (Swagger)

Interface interativa para testar as requisições HTTP diretamente do seu navegador em tempo real.

Acessar Swagger
ReDoc UI

Documentação de Referência (ReDoc)

Uma documentação limpa, organizada e focada na leitura para facilitar a compreensão dos schemas da API.

Acessar ReDoc

Exemplo de Ingestão de Produto

Para cadastrar produtos automaticamente a partir de um script ou bot de monitoramento, envie um **POST** para `/api/ingest` contendo o cabeçalho `x-api-key` da sua loja. O sistema irá extrair o identificador (ASIN da Amazon, etc.) e convertê-lo automaticamente com a sua tag de afiliado configurada.

cURL (Terminal) 
curl -X POST "https://api.marketcity.com.br/api/ingest" \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_CHAVE_DE_API_DA_LOJA" \
  -d '{
    "title": "Console Playstation 5 Slim",
    "original_url": "https://www.amazon.com.br/dp/B0CXF62G1X",
    "price": 3899.00,
    "category": "Games",
    "image_url": "https://m.media-amazon.com/images/I/51pS9k94nQL._AC_SX679_.jpg"
  }'
Python (Requests) 
import requests

url = "https://api.marketcity.com.br/api/ingest"
headers = {
    "x-api-key": "SUA_CHAVE_DE_API_DA_LOJA",
    "Content-Type": "application/json"
}
payload = {
    "title": "Console Playstation 5 Slim",
    "original_url": "https://www.amazon.com.br/dp/B0CXF62G1X",
    "price": 3899.00,
    "category": "Games",
    "image_url": "https://m.media-amazon.com/images/I/51pS9k94nQL._AC_SX679_.jpg"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())