Download the PHP package cjrasmussen/bluesky-api without Composer
On this page you can find all versions of the php package cjrasmussen/bluesky-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cjrasmussen/bluesky-api
More information about cjrasmussen/bluesky-api
Files in cjrasmussen/bluesky-api
Package bluesky-api
Short Description Simple helper for interacting with the Bluesky API/AT protocol
License MIT
Homepage https://cjr.dev
Informations about the package bluesky-api
BlueskyApi
Simple class for making requests to the Bluesky API/AT protocol. Not affiliated with Bluesky.
Usage
Starting a session
Starting a session requires a handle and password.
Getting a refresh token
If you're running up against rate limits by repeatedly creating a session, you may want to cache a refresh token and use that to refresh your session instead of starting a new one. Cache it however you want for later usage, or see the session helper below.
Refreshing a session
You can use that cached refresh token later to refresh your session instead of starting a new session.
Sending a message
Sending a message with an attached image
This assumes that your image file is a PNG
Using the session helper to manage refresh token caching
As mentioned above, you can manually cache a session refresh token however you want. The BlueskyApiSessionHelper::auth method is one way of doing that. Provide the path to a file containing a refresh token and the method will refresh your session and update the cache file with the new refresh token. Optionally provide a handle and (app) password to fall back on creating a new session if the refresh token fails.
Getting response header for API requests
Bluesky returns data about rate limits in the header of each API request response. The most recent request response header can be accessed as a string as follows:
The header can then be parsed as necessary.
Installation
Simply add a dependency on cjrasmussen/bluesky-api to your composer.json file if you use Composer to manage the dependencies of your project:
Although it's recommended to use Composer, you can actually include the file(s) any way you want.
Further Reference
It's not much, but I do have some Bluesky API-related stuff on my blog. Additionally, there's an unofficial Discord for Bluesky API users with a PHP-focused channel.
License
BlueskyApi is MIT licensed.
All versions of bluesky-api with dependencies
ext-curl Version *
ext-json Version *