Update Looker

📖 Descrição

Este endpoint atualiza um looker existente. Permite atualizar o nome e/ou a lista de cryptos. O looker deve pertencer ao email fornecido.

🛠️ Requisição

Método

PUT

URL

/v1/lookers

Parâmetros de Query

Parâmetro	Tipo	Obrigatório	Descrição
`id`	string	Sim	ID do looker
`email`	string	Sim	Email do usuário (para validação de propriedade)

Request Body

Campo	Tipo	Obrigatório	Descrição
`name`	string	Não	Novo nome do looker
`cryptos`	array de string	Não	Nova lista de cryptos (máximo 6)

Validações

Pelo menos um campo (name ou cryptos) deve ser fornecido
Se name for fornecido, não pode ser vazio
Se cryptos for fornecido, não pode ser vazio e deve ter no máximo 6 itens
O looker deve pertencer ao email fornecido

Exemplo de Requisição (atualizar apenas nome)

curl -X PUT "http://localhost:8080/v1/lookers?id=507f1f77bcf86cd799439011&email=user@example.com" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Portfolio Name"
  }'

Exemplo de Requisição (atualizar apenas cryptos)

curl -X PUT "http://localhost:8080/v1/lookers?id=507f1f77bcf86cd799439011&email=user@example.com" \
  -H "Content-Type: application/json" \
  -d '{
    "cryptos": ["BTCUSDT", "ETHUSDT", "BNBUSDT", "SOLUSDT"]
  }'

Exemplo de Requisição (atualizar ambos)

curl -X PUT "http://localhost:8080/v1/lookers?id=507f1f77bcf86cd799439011&email=user@example.com" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Portfolio Name",
    "cryptos": ["BTCUSDT", "ETHUSDT", "BNBUSDT", "SOLUSDT"]
  }'

Exemplo de Resposta (200 OK)

{
  "id": "507f1f77bcf86cd799439011",
  "email": "user@example.com",
  "name": "Updated Portfolio Name",
  "cryptos": ["BTCUSDT", "ETHUSDT", "BNBUSDT", "SOLUSDT"],
  "timestamp": 1234567890000
}

📝 Códigos de Resposta

200 OK: Looker atualizado com sucesso

400 Bad Request:

Invalid request body: Corpo da requisição inválido
id parameter is required: ID não fornecido
email parameter is required: Email não fornecido
name cannot be empty: Nome fornecido está vazio
cryptos cannot be empty: Lista de cryptos está vazia
maximum 6 cryptos allowed: Mais de 6 cryptos fornecidas
no fields to update: Nenhum campo fornecido para atualização

403 Forbidden: looker does not belong to this email - O looker não pertence ao email fornecido

404 Not Found: looker not found - Looker não encontrado

500 Internal Server Error: Erro interno do servidor

🔍 Notas

Pelo menos um campo (name ou cryptos) deve ser fornecido para atualização
Usuários só podem modificar seus próprios lookers (validação por email)
A atualização substitui completamente os campos fornecidos

API Documentation

Endpoint Examples

📖 Descrição

🛠️ Requisição

Método

URL

Parâmetros de Query

Request Body

Validações

Exemplo de Requisição (atualizar apenas nome)

Exemplo de Requisição (atualizar apenas cryptos)

Exemplo de Requisição (atualizar ambos)

Exemplo de Resposta (200 OK)

📝 Códigos de Resposta

🔍 Notas

​📖 Descrição

​🛠️ Requisição

​Método

​URL

​Parâmetros de Query

​Request Body

​Validações

​Exemplo de Requisição (atualizar apenas nome)

​Exemplo de Requisição (atualizar apenas cryptos)

​Exemplo de Requisição (atualizar ambos)

​Exemplo de Resposta (200 OK)

​📝 Códigos de Resposta

​🔍 Notas

📖 Descrição

🛠️ Requisição

Método

URL

Parâmetros de Query

Request Body

Validações

Exemplo de Requisição (atualizar apenas nome)

Exemplo de Requisição (atualizar apenas cryptos)

Exemplo de Requisição (atualizar ambos)

Exemplo de Resposta (200 OK)

📝 Códigos de Resposta

🔍 Notas