Skip to main content

​
📖 Descrição

Este endpoint permite criar um novo looker (lista de monitoramento de criptomoedas) para um usuário. Cada looker pode ter um nome personalizado e conter até 6 criptomoedas.

​
🛠️ Requisição

​
Método

POST

​
URL

/v1/lookers

​
Request Body

CampoTipoObrigatórioDescrição
emailstringSimEmail do usuário
namestringNãoNome do looker
cryptosarray de stringNãoLista de tickers de criptomoedas (máximo 6)

​
Validações

  • Email é obrigatório
  • Nome e cryptos são opcionais
  • Máximo de 6 cryptos por looker

​
Exemplo de Requisição (completo)

curl -X POST http://localhost:8080/v1/lookers \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "name": "My Portfolio",
    "cryptos": ["BTCUSDT", "ETHUSDT", "ADAUSDT"]
  }'

​
Exemplo de Requisição (mínimo - apenas email)

curl -X POST http://localhost:8080/v1/lookers \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]"
  }'

​
Exemplo de Resposta (201 Created)

{
  "id": "507f1f77bcf86cd799439011",
  "email": "[email protected]",
  "name": "My Portfolio",
  "cryptos": ["BTCUSDT", "ETHUSDT", "ADAUSDT"],
  "timestamp": 1234567890000
}

​
📝 Códigos de Resposta

201 Created: Looker criado com sucesso
400 Bad Request:
  • Invalid request body: Corpo da requisição inválido
  • email is required: Email não fornecido
  • maximum 6 cryptos allowed: Mais de 6 cryptos fornecidas
500 Internal Server Error: Failed to create looker - Erro interno do servidor

​
🔍 Notas

  • Um usuário pode ter múltiplos lookers
  • Cada looker pode ter no máximo 6 cryptos
  • Email é obrigatório na criação, nome e cryptos são opcionais
  • O ID do looker é um ObjectID do MongoDB gerado automaticamente