Skip to main content

​
📖 Descrição

Este endpoint permite criar uma nova criptomoeda favorita para um usuário, vinculando o email ao ticker da criptomoeda.

​
🛠️ Requisição

​
Método

POST

​
URL

/v1/favorite-cryptos

​
Request Body

CampoTipoObrigatórioDescrição
emailstringSimEmail do usuário
tickerstringSimTicker da criptomoeda (ex: BTCUSDT, ETHUSDT)

​
Exemplo de Requisição

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

​
Exemplo de Resposta (201 Created)

{
  "id": "507f1f77bcf86cd799439011",
  "email": "[email protected]",
  "ticker": "BTCUSDT",
  "timestamp": 1234567890000
}

​
📝 Códigos de Resposta

201 Created: Crypto favorita criada com sucesso
400 Bad Request:
  • Invalid request body: Corpo da requisição inválido
  • email is required: Email não fornecido
  • ticker is required: Ticker não fornecido
409 Conflict: favorite crypto already exists - A combinação email+ticker já existe
500 Internal Server Error: Failed to create favorite crypto - Erro interno do servidor

​
🔍 Notas

  • A combinação email + ticker deve ser única
  • Um usuário pode ter múltiplas cryptos favoritas
  • Não há limite de cryptos favoritas por usuário