Referencia de la API

¿Está libre un handle?

GET/handles/{name}/availability

Aplica exactamente las reglas del servidor para una reclamación: formato, nombres reservados, palabras ofensivas y, por último, si algún bot ya lo tiene.

Parámetros

Respuestas

Ejemplo

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

El DID detrás de un handle reclamado

GET/resolve/{handle}

La misma respuesta que `https://<handle>/.well-known/atproto-did`. Solo handles `*.bluesky.bot`.

Parámetros

Respuestas

Ejemplo

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

Bots publicados en el directorio

GET/bots

Solo los bots que su creador publicó en el directorio, del más reciente al más antiguo. Paginación por cursor: pasa el `cursor` de una página para obtener la siguiente; es null en la última página.

Parámetros

Respuestas

Ejemplo

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

Un bot publicado en el directorio

GET/bots/{handle}

Parámetros

Respuestas

Ejemplo

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

Cambiar un código de inicio de sesión de la CLI por un token

POST/cli/token

Paso 4 de `bsbot login`: el código de un solo uso que /cli/authorize entregó a la dirección loopback de la CLI, con el verificador PKCE y la misma URI de redirección. Un código sirve una vez y durante dos minutos; un intento fallido lo invalida. El token es válido 30 días. Límite de uso por IP (`cliToken`).

Respuestas

Ejemplo

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

La cuenta detrás del token

GET/me

Respuestas

Ejemplo

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

Tus bots

GET/me/bots

Todos los bots de tu cuenta, publicados en el directorio o no, del más antiguo al más reciente. Añade un bot desde el panel: hace falta iniciar sesión en la cuenta del bot.

Respuestas

Ejemplo

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

Reclamar un handle para uno de tus bots y aplicárselo

POST/me/bots/{did}/claim

Las propias reglas del panel: formato, nombres reservados, palabras ofensivas, disponibilidad (garantizada por un índice único) y periodo de gracia de los handles liberados. Después, el handle del bot se cambia en Bluesky al momento; `switch` dice cómo fue. Cambiar el handle de un bot que ya tiene uno libera el anterior.

Parámetros

Respuestas

Ejemplo

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

Volver a pedir al PDS del bot que use su handle reclamado

POST/me/bots/{did}/switch

Parámetros

Respuestas

Ejemplo

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

Comprobar si el handle reclamado está activo en Bluesky

POST/me/bots/{did}/verify

Parámetros

Respuestas

Ejemplo

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

Liberar el handle de un bot

POST/me/bots/{did}/release

El bot vuelve a su handle anterior de Bluesky cuando es posible, el handle deja de resolverse y queda bloqueado para los demás durante su periodo de gracia.

Parámetros

Respuestas

Ejemplo

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

Revocar el token de esta petición

DELETE/me/token

Lo que llama `bsbot logout`.

Respuestas

Ejemplo

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