> ## 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.

# Colección pública

> Elija un identificador público y comparta solo los registros que seleccione para visibilidad pública.

Una colección pública enumera los registros que ha seleccionado para compartir públicamente. Los visitantes pueden abrir cada registro y ejecutar una verificación actual. Una lista no establece de forma independiente la autoría, la propiedad o la veracidad de una afirmación.

## Elegir una dirección de cobro

1. Inicie sesión en su espacio de trabajo personal y abra **Perfil → Colección pública**.
2. Ingrese un identificador usando de 3 a 30 letras, números, guiones o guiones bajos. Los identificadores distinguen entre mayúsculas y minúsculas.
3. Revise qué registros tienen visibilidad pública y confirme el efecto.
4. Seleccione **Guardar dirección de colección**. Si el identificador ya está en uso, elija otro.

Su dirección de colección es `https://verify.truthlocks.com/portfolio/your-handle`. Muestra el identificador público y hasta 100 registros públicos, con el recuento total disponible. No publica su correo electrónico de inicio de sesión ni el nombre de visualización de su perfil privado.

Se requiere una cuenta personal activa. Los espacios de trabajo empresariales y las cuentas suspendidas no tienen una colección personal pública a través de este endpoint.

## Cambiar o deshabilitar la dirección

Puede cambiar su identificador en la misma página. Los enlaces a la dirección anterior dejarán de localizar su colección, y el identificador anterior podrá estar disponible para otra cuenta.

Para deshabilitar la dirección de la colección, deje el identificador vacío y confirme. Esto **no** hace que los registros públicos individuales sean privados ni invalida los enlaces de registros existentes. Abra **Su colección → un registro → Cambiar visibilidad** para ajustar la visibilidad descriptiva de un registro.

## Ejemplo de API

Utilice un token de portador de sesión de consumidor. Una clave de API comercial no autoriza cambios en un identificador de colección personal.

```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"}'
```

Una respuesta exitosa informa `status: updated` y el `username` guardado. Envíe `{"username":""}` para deshabilitar la dirección. Un conflicto devuelve HTTP 409; los caracteres no válidos devuelven HTTP 400.

Los lectores públicos pueden llamar a `GET /v1/consumer/portfolio/{username}` sin credenciales. La respuesta contiene el identificador público, las proyecciones de registros públicos y un recuento total. HTTP 404 significa que no se encontró ninguna colección personal activa coincidente. Otras fallas deben tratarse como indisponibilidad, no como evidencia de que un registro no es válido.


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