WebCull
cli

Authentification

Autorisez plusieurs comptes CLI, sélectionnez-en un par son hash, vérifiez son identité, puis déconnectez-le en toute sécurité.

Autoriser La CLI Avec Un Flux D Approbation Navigateur

La CLI utilise un flux d'approbation de courte durée dans le navigateur. N'approuvez que les demandes que vous avez lancées avec webcull login; l'approbation crée un jeton CLI distinct et limité.

Où votre jeton d'accès est stocké

La connexion à la CLI est distincte de celle du navigateur et de l'extension. Chaque compte connecté reçoit son propre jeton d'accès, que votre ordinateur conserve dans un stockage de mots de passe protégé. Le fichier de paramètres de la CLI répertorie vos comptes connectés, mais ne contient jamais leurs jetons.

Demarrer La Connexion Et Verifier Le Compte

webcull login
webcull accounts
webcull whoami --account <account-hash>
webcull login
Lance l'autorisation et ouvre la page d'approbation dans le navigateur.
webcull auth login
Alias de webcull login.
webcull accounts
Affiche chaque compte autorisé localement avec son identifiant utilisateur, son hash, son expiration et son état actif, sans imprimer les tokens.
webcull whoami --account <account-hash>
Affiche le compte autorisé et l'expiration du jeton.

Garder plusieurs comptes connectés en même temps

Chaque connexion réussie ajoute une autre autorisation locale de la CLI. Utilisez --account <hash|id> pour sélectionner un compte pour une commande. Sans cette option, les commandes ordinaires utilisent le dernier compte consulté avec succès.

webcull accounts
webcull bookmarks count --account abc123 --path /
webcull bookmarks search --account abc123 --query 'project notes' --limit 20
{
  "success": "true",
  "active_account": "abc123",
  "accounts": [
    {
      "number": 1,
      "active": true,
      "user": {
        "id": 42,
        "hash": "abc123",
        "name": "Personal",
        "email": "person@example.com"
      }
    }
  ]
}
Agent selection

Les agents doivent exécuter webcull accounts au début d'un nouveau contexte WebCull. Avec un seul compte, ils utilisent automatiquement son hash. Avec plusieurs comptes, ils affichent une liste numérotée, demandent lequel s'applique et incluent ce hash dans chaque commande suivante.

Choisir le compte avant de révoquer l'accès

webcull logout
webcull logout --account abc123
webcull logout --account abc123 --local-only

Lorsque plusieurs comptes sont connectés, la commande interactive webcull logout affiche un sélecteur numéroté. Les clients non interactifs reçoivent une réponse de sélection de compte et doivent relancer la commande avec le hash ou l'identifiant utilisateur prévu.

La déconnexion normale révoque le token de serveur sélectionné avant de supprimer son identifiant local. Utilisez --local-only uniquement lorsque WebCull est inaccessible et que vous devez tout de même supprimer l'accès de cet appareil. Cette option supprime l'identifiant local sélectionné sans révoquer le token de serveur, qui peut rester utilisable jusqu'à son expiration.

Lire La Reponse Du Compte

{
  "success": "true",
  "user": {
    "id": 42,
    "hash": "abc123abc123abc123abc123abc123",
    "email": "person@example.com"
  },
  "scopes": ["bookmarks:read", "bookmarks:write"],
  "expires": 1781300000
}

Utilisez scopes pour vérifier les capacités de ce jeton. Les commandes de lecture exigent bookmarks:read. La création, la mise à jour, la création de rappels et leur annulation exigent bookmarks:write.

Étape suivante cli Lectures De Favoris Utilisez les commandes count, tree et get pour examiner l'emplacement des favoris et récupérer des enregistrements précis.