https://github.com/shinmera/clohost
A Common Lisp client library for the Cohost API
https://github.com/shinmera/clohost
cohost cohost-api
Last synced: 5 months ago
JSON representation
A Common Lisp client library for the Cohost API
- Host: GitHub
- URL: https://github.com/shinmera/clohost
- Owner: Shinmera
- License: zlib
- Created: 2023-09-12T15:29:44.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-05T07:53:59.000Z (almost 2 years ago)
- Last Synced: 2024-08-05T09:17:38.174Z (almost 2 years ago)
- Topics: cohost, cohost-api
- Language: Common Lisp
- Homepage: https://shinmera.github.io/clohost/
- Size: 77.1 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.mess
- License: LICENSE
Awesome Lists containing this project
README
# About Clohost
This is a client implementation for the "Cohost"(https://cohost.org) API. The API is not currently officially documented, so the work in this library was done via observation of how the existing site interacts with its API. It may break if changes are made by ASSC.
## How To
Create a ``client`` instance and ``log in``. If successful, your ``client`` will turn into an ``account`` and you'll be able to start making changes and querying for data. Please see the documentation for the ``account`` objects and other ``entity``s in the API.
For something simple, you can make a new post with
:: common lisp
(make-post (default-page *)
:tags '("cohost api")
:content "Posting with https://github.com/shinmera/clohost,
Hello @Shinmera!")
::
You can also ``edit`` it, ``reply`` to it, or ``destroy`` the post again. Again, please see the definition cross references for more information on what you can do.
If you'd like to save your session for later use, you can retrieve the ``token`` of the account, and then recreate it later via ``(make-instance 'client :token token)``.