Référence de l’API

Un handle est-il libre ?

GET/handles/{name}/availability

Applique exactement les règles serveur d’une réservation : format, noms réservés, mots injurieux, puis si un bot le détient déjà.

Paramètres

Réponses

Exemple

curl https://bluesky.bot/api/v1/handles/weather/availability

Le DID derrière un handle réservé

GET/resolve/{handle}

Même réponse que `https://<handle>/.well-known/atproto-did`. Seulement les handles `*.bluesky.bot`.

Paramètres

Réponses

Exemple

curl https://bluesky.bot/api/v1/resolve/weather.bluesky.bot

Bots inscrits dans l’annuaire

GET/bots

Seulement les bots que leur créateur a inscrits dans l’annuaire, du plus récent au plus ancien. Pagination par curseur : passez le `cursor` d’une page pour obtenir la suivante ; il vaut null sur la dernière page.

Paramètres

Réponses

Exemple

curl https://bluesky.bot/api/v1/bots

Un bot inscrit dans l’annuaire

GET/bots/{handle}

Paramètres

Réponses

Exemple

curl https://bluesky.bot/api/v1/bots/weather.bluesky.bot

Échanger un code de connexion de la CLI contre un jeton

POST/cli/token

Étape 4 de `bsbot login` : le code à usage unique que /cli/authorize a remis à l’adresse de loopback de la CLI, avec le vérificateur PKCE et la même URI de redirection. Un code sert une seule fois, pendant deux minutes ; une tentative ratée le consomme. Le jeton est valable 30 jours. Limité en débit par IP (`cliToken`).

Réponses

Exemple

curl \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"code":"…","code_verifier":"…","redirect_uri":"…"}' \
  https://bluesky.bot/api/v1/cli/token

Le compte derrière le jeton

GET/me

Réponses

Exemple

curl \
  -H "Authorization: Bearer $BLUESKY_BOT_TOKEN" \
  https://bluesky.bot/api/v1/me

Vos bots

GET/me/bots

Tous les bots de votre compte, inscrits dans l’annuaire ou non, du plus ancien au plus récent. Ajoutez un bot depuis le tableau de bord : il faut se connecter au compte du bot.

Réponses

Exemple

curl \
  -H "Authorization: Bearer $BLUESKY_BOT_TOKEN" \
  https://bluesky.bot/api/v1/me/bots

Réserver un handle pour l’un de vos bots, et le lui appliquer

POST/me/bots/{did}/claim

Les règles du tableau de bord : format, noms réservés, mots injurieux, disponibilité (garantie par un index unique), délai de grâce des handles libérés. Le handle du bot est ensuite changé sur Bluesky immédiatement ; `switch` indique comment cela s’est passé. Changer le handle d’un bot qui en a déjà un libère l’ancien.

Paramètres

Réponses

Exemple

curl \
  -X POST \
  -H "Authorization: Bearer $BLUESKY_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"weather"}' \
  https://bluesky.bot/api/v1/me/bots/did:plc:yourbot/claim

Redemander au PDS du bot d’utiliser son handle réservé

POST/me/bots/{did}/switch

Paramètres

Réponses

Exemple

curl \
  -X POST \
  -H "Authorization: Bearer $BLUESKY_BOT_TOKEN" \
  https://bluesky.bot/api/v1/me/bots/did:plc:yourbot/switch

Vérifier si le handle réservé est actif sur Bluesky

POST/me/bots/{did}/verify

Paramètres

Réponses

Exemple

curl \
  -X POST \
  -H "Authorization: Bearer $BLUESKY_BOT_TOKEN" \
  https://bluesky.bot/api/v1/me/bots/did:plc:yourbot/verify

Libérer le handle d’un bot

POST/me/bots/{did}/release

Le bot retrouve son handle Bluesky précédent quand c’est possible, le handle cesse d’être résolu, et il reste bloqué pour les autres pendant son délai de grâce.

Paramètres

Réponses

Exemple

curl \
  -X POST \
  -H "Authorization: Bearer $BLUESKY_BOT_TOKEN" \
  https://bluesky.bot/api/v1/me/bots/did:plc:yourbot/release

Révoquer le jeton de cette requête

DELETE/me/token

Ce qu’appelle `bsbot logout`.

Réponses

Exemple

curl \
  -X DELETE \
  -H "Authorization: Bearer $BLUESKY_BOT_TOKEN" \
  https://bluesky.bot/api/v1/me/token