Cadastrar usuário na lista de bloqueio

Registra o rosto de um novo usuário na lista negra compartilhada. O userId deve ser único dentro da coleção. Somente o cliente que registrou o rosto poderá recuperar o userId completo nos resultados da pesquisa e excluir esta entrada.

Endpoint

PUT /users/blacklist/{userId}

Autenticação

Tipo	Localização	Nome
API Key	Cabeçalho	x-api-key

Corpo da solicitação

Content-Type: application/json

Parâmetros de rota

Parâmetro	Tipo	Obrigatório	Descrição
userId	string	Sim	Identificador único do usuário. Este ID deve ser único dentro da coleção de lista negra.

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
face	string	Sim	Imagem do rosto do usuário codificada em Base64. Os formatos compatíveis são JPEG e PNG. Tamanho máximo suportado: 5MB.

Exemplo de solicitação

{
  "face": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAdUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
}

Respostas

200 Sucesso

Usuário registrado com sucesso na lista negra. Esta resposta não inclui corpo.

400 Requisição inválida

Exemplo de resposta: userId duplicado

{
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid request.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": ["the provided userId already exists"]
}

Exemplo de resposta: imagem facial inválida

{
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid request.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": ["no face was detected in the provided image"]
}

401 Não autorizado

{
  "message": "Unauthorized"
}

403 Acesso negado

{
  "Message": "User is not authorized to access this resource with an explicit deny"
}

404 Não encontrado

{
  "status": 404,
  "title": "Not Found",
  "detail": "O servidor não consegue encontrar o recurso solicitado.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404"
}