bsky-bridge

Description

This is implement of ATProtocol for BlueSky. Providing helper methods for authentication, fetching timelines, and managing content.

Requirements

• Docker
• Docker Compose

Usage

docker-compose up -d

Rest API Endpoints

POST

• Endpoint: /login

  • Request Body: JSON object
    • identifier: A unique identifier for the user (not null)
    • password: The user's password (not null)

• Endpoint: /refresh

  • Request Headers:
    • Authorization: Bearer {token} (caution! this token is refresh token)
    • Did: {did}
    • Handle: {handle}

• Endpoint: /post

  • Request Headers:
    • Authorization: Bearer {token}
    • Did: {did}
    • Handle: {handle}
  • Request Body: JSON object
    • text: String

• Endpoint: /repost

  • Request Headers:
    • Authorization: Bearer {token}
    • Did: {did}
    • Handle: {handle}
  • Request Body: JSON object
    • cid: String
    • uri: String

• Endpoint: /like

  • Request Headers:
    • Authorization: Bearer {token}
    • Did: {did}
    • Handle: {handle}
  • Request Body: JSON object
    • cid: String
    • uri: String

• Endpoint: /follow

  • Request Headers:
    • Authorization: Bearer {token}
    • DID: {did}
    • Handle: {handle}
  • Request Body: JSON object
    • did: String

• Endpoint: /block

  • Request Headers:
    • Authorization: Bearer {token}
    • Did: {did}
    • Handle: {handle}
  • Request Body: JSON object
    • cid: String
    • uri: String

DELETE

• Endpoint: /organize/posts

  • Path Variables: post
  • Request Headers:
    • Authorization: Bearer {token}
    • DID: {did}
    • Handle: {handle}
  • Request Body: JSON object
    • from: LocalDateTime

• Endpoint: /post

  • Path Variables: post
  • Request Headers:
    • Authorization: Bearer {token}
    • DID: {did}
    • Handle: {handle}
  • Request Body: JSON object
    • rkey: String

GET

• Endpoint: /author-feed

  • Request Headers:
    • Authorization: Bearer {token}
    • DID: {did}
    • Handle: {handle}
  • Query Parameters:
    • did: Optional String (default: current user's DID)
    • limit: Optional Integer
    • cursor: Optional String

• Endpoint: /timeline

  • Request Headers:
    • Authorization: Bearer {token}
    • DID: {did}
    • Handle: {handle}
  • Query Parameters:
    • algorithm: Optional String
    • limit: Optional Integer
    • cursor: Optional String

• Endpoint: /did/{did}/post/{post}/likes

  • Path Variables: did, postId
  • Request Headers:
    • Authorization: Bearer {token}
    • DID: {did}
    • Handle: {handle}
  • Query Parameters:
    • limit: Optional Integer
    • cursor: Optional String

• Endpoint: /followers

  • Request Headers:
    • Authorization: Bearer {token}
    • DID: {did}
    • Handle: {handle}
  • Query Parameters:
    • did: Optional String (default: current user's DID)
    • limit: Optional Integer
    • cursor: Optional String

• Endpoint: /follows

  • Request Headers:
    • Authorization: Bearer {token}
    • DID: {did}
    • Handle: {handle}
  • Query Parameters:
    • did: Optional String (default: current user's DID)
    • limit: Optional Integer
    • cursor: Optional String

WIP

Support Twitter and BlueSky API