This is a very basic script that renders the YAML file (in the OpenAPI 3.0 spec) that is used as the source for Firefly III's API documentation. I wrote it because the API YAML file was well over 1400 lines before I got sick of editing such a large file. The current stitched result is well over 7500 lines at the time of writing.
What it does is simply join all YAML files in /yaml/
together, preceded by the start.yaml.twig
file in the /templates/
directory.
-
Rename
.env.example
to.env
and adjust the variables accordingly, e.g.API_VERSION=0.10.0 API_DESTINATION=./ API_ROOT=./
-
Install dependencies via Composer
$ composer install
-
Install PHP
yaml.so
extension. It should be added to yourphp.ini
automatically.$ pecl install yaml
-
Generate
firefly-iii-${API_VERSION}.yaml
file$ php index.php
The resulting firefly-iii-${API_VERSION}.yaml
file can be imported into your favorite API development environment to play around with, e.g. Postman.
I'm actively writing all API documentation, so the file may change.
Feel free to create a PR on anything. If you want to change endpoints, check out /yaml/paths
. Or edit objects in /yaml/schemas
. This is my first API document so feel free to tell me how to improve.
You can see the result on this page.
If you need support using Firefly III or the associated tools, come find us!
- GitHub Discussions for questions and support
- Gitter.im for a good chat and a quick answer
- GitHub Issues for bugs and issues
- Follow me around for news and updates on Mastodon
If you feel Firefly III made your life better, consider contributing as a sponsor. Please check out my Patreon and GitHub Sponsors page for more information. Thank you for considering.