A local-first personal finance app
:pencil: highlight that Actual does not have a HTTP API (#428)
Matiss Janis Aboltins64a254b12dcb
diff --git a/docs/api/index.md b/docs/api/index.mdindex 3eb67c0aba..5944ad61e0 100644--- a/docs/api/index.md+++ b/docs/api/index.md@@ -2,7 +2,13 @@import { Method, MethodBox } from './types';-The API gives you full programmatic access to your data. If you are a developer, you can use this to import transactions from a custom source, export data to another app like Excel, or write anything you want on top of Actual.+:::warning++Many people mistake the term "API" for a HTTP and/or REST-full API. Actual **does not** expose HTTP endpoints that can be called. We do, however, offer a NPM package - API - that allows interacting with the product programmatically.++:::++The API gives you full programmatic access to your data. It allows to run the UI in _headless_ mode thus interacting with it as-if it was a user clicking around in it. If you are a developer, you can use this to import transactions from a custom source, export data to another app like Excel, or write anything you want on top of Actual.One thing to keep in mind: Actual is not like most other apps. While your data is stored on a server, the server does not have the functionality for analyzing details of or modifying your budget. As a result, the API client contains all the code necessary to query your data and will work on a local copy. Right now, the primary use case is custom importers and exporters.diff --git a/docs/faq.md b/docs/faq.mdindex c6a036b124..3846ef2df5 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -18,16 +18,10 @@**A.** That depends how you’re hosting it.- - PikaPods seems to refresh their image automatically.+ - PikaPods seems to refresh their image automatically around a week after the release goes out.- Actual builds and publishes an updated docker image with each release.- If you’re on Fly.io we have a [guide for that too](./install/fly.md#updating-actual).-- **Q.** _I have deployed actual to Fly.io but I am being charged, why is this?_-- **A.** While we wouldn’t know for certain without seeing your configuration, it is likely that during- deployment you created a Postgres database. Actual doesn’t need this so you can just delete it and- charges should then stop.-- **Q.** _I'm new to budgeting and learned with nYNAB. I'm not completely clear on how to handle creditcards. I largely charge almost everything to them for rewards and pay off in full. How do I trackwhat's available/budgeted for per payment?_@@ -52,3 +46,11 @@In that case, you need to keep some negative dollars from touching positive dollars by sticking themin a category. Actual's default assumption is that you can pay off any card in full at any time andnot touch your budget to do it. (Credit: evequefou)++- **Q.** _Does Actual Budget have an API? What are the endpoints?_++ **A.** Actual does not have a REST API with endpoints that you can just call. However, we do have an API NPM package that allows programmatic access to the budget. It runs the UI in _headless_ mode and allows performing many of the same operations that you can perform by clicking around the UI.++ The reason why Actual doesn't have REST-full endpoints is - Actual is a local-first product with the primary database hosted on your local device rather than in a remote server. There is an optional sync server that can be set-up (i.e. `actual-server`), but it does not have the full database (but rather an archival backup of some point-in-time as well as _messages_ with the updates applied to the backup).++ Read more about the API package in the [API documentation pages](./api/index.md).