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

# Collection publique

> Choisissez un identifiant public et ne partagez que les enregistrements que vous sélectionnez pour une visibilité publique.

Une collection publique répertorie les enregistrements que vous avez sélectionnés pour le partage public. Les visiteurs peuvent ouvrir chaque enregistrement et effectuer une vérification actuelle. Une liste n'établit pas indépendamment la paternité, la propriété ou la véracité d'une affirmation.

## Choisir une adresse de collecte

1. Connectez-vous à votre espace de travail personnel et ouvrez **Profil → Collection publique**.
2. Saisissez un identifiant de 3 à 30 lettres, chiffres, tirets ou underscores. Les identifiants sont sensibles à la casse.
3. Passez en revue les enregistrements ayant une visibilité publique et confirmez l'effet.
4. Sélectionnez **Enregistrer l'adresse de collecte**. Si le handle est déjà utilisé, choisissez-en un autre.

Votre adresse de collection est `https://verify.truthlocks.com/portfolio/your-handle`. Elle affiche l'identifiant public et jusqu'à 100 enregistrements publics, avec le nombre total disponible. Elle ne publie pas votre e-mail de connexion ni votre nom d'affichage de profil privé.

Un compte personnel actif est requis. Les espaces de travail professionnels et les comptes suspendus n'ont pas de collection personnelle publique via ce point de terminaison.

## Modifier ou désactiver l'adresse

Vous pouvez changer votre identifiant sur la même page. Les liens vers l'adresse précédente ne localiseront plus votre collection, et l'identifiant précédent pourra devenir disponible pour un autre compte.

Pour désactiver l'adresse de la collection, laissez le champ vide et confirmez. Cela ne rend **pas** les enregistrements publics individuels privés et n'invalide pas les liens d'enregistrement existants. Ouvrez **Votre collection → un enregistrement → Modifier la visibilité** pour ajuster la visibilité descriptive d'un enregistrement.

## Exemple d'API

Utilisez un jeton de session consommateur. Une clé API d'entreprise n'autorise pas les modifications d'un identifiant de collection personnelle.

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

Une réponse réussie signale `status: updated` et le `username` enregistré. Envoyez `{"username":""}` pour désactiver l'adresse. Un conflit renvoie HTTP 409 ; des caractères invalides renvoient HTTP 400.

Les lecteurs publics peuvent appeler `GET /v1/consumer/portfolio/{username}` sans identifiants. La réponse contient l'identifiant public, les projections d'enregistrements publics et un nombre total. HTTP 404 signifie qu'aucune collection personnelle active correspondante n'a été trouvée. Les autres échecs doivent être traités comme une indisponibilité, et non comme une preuve qu'un enregistrement est invalide.


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