> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Coleção pública

> Escolha um identificador público e compartilhe apenas os registros que você selecionar para visibilidade pública.

Uma coleção pública lista os registros que você selecionou para compartilhamento público. Os visitantes podem abrir cada registro e executar uma verificação atual. Uma listagem não estabelece independentemente autoria, propriedade ou a verdade de uma reivindicação.

## Escolha um endereço de coleta

1. Faça login em seu espaço de trabalho pessoal e abra **Perfil → Coleção pública**.
2. Insira um identificador usando 3 a 30 letras, números, hífens ou sublinhados. Os identificadores diferenciam maiúsculas de minúsculas.
3. Revise quais registros têm visibilidade pública e confirme o efeito.
4. Selecione **Salvar endereço de coleta**. Se o identificador já estiver em uso, escolha outro.

Seu endereço de coleta é `https://verify.truthlocks.com/portfolio/your-handle`. Ele exibe o identificador público e até 100 registros públicos, com a contagem total disponível. Ele não publica seu e-mail de login ou nome de exibição de perfil privado.

É necessária uma conta pessoal ativa. Espaços de trabalho empresariais e contas suspensas não possuem uma coleção pessoal pública através deste endpoint.

## Alterar ou desativar o endereço

Você pode alterar seu identificador na mesma página. Os links para o endereço anterior deixarão de localizar sua coleção, e o identificador anterior poderá ficar disponível para outra conta.

Para desativar o endereço de coleta, deixe o campo vazio e confirme. Isso **não** torna registros públicos individuais privados nem invalida links de registros existentes. Abra **Sua coleção → um registro → Alterar visibilidade** para ajustar a visibilidade descritiva de um registro.

## Exemplo de API

Use um token de portador de sessão de consumidor. Uma chave de API de negócios não autoriza alterações em um identificador de coleção pessoal.

```bash theme={null}
curl -X PUT https://api.truthlocks.com/v1/consumer/me/username \
  -H "Authorization: Bearer <consumer-session-token>" \
  -H "Content-Type: application/json" \
  -d '{"username":"my-collection"}'
```

Uma resposta bem-sucedida relata `status: updated` e o `username` salvo. Envie `{"username":""}` para desativar o endereço. Um conflito retorna HTTP 409; caracteres inválidos retornam HTTP 400.

Leitores públicos podem chamar `GET /v1/consumer/portfolio/{username}` sem credenciais. A resposta contém o identificador público, as projeções de registro público e uma contagem total. HTTP 404 significa que nenhuma coleção pessoal ativa correspondente foi encontrada. Outras falhas devem ser tratadas como indisponibilidade, não como evidência de que um registro é inválido.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.