Integration with third party applications¶
You can integrate Budget Blitz for Android with other applications. For example, you can connect Budget Blitz for Android with a voice assistant and create transactions by voice. Another hint is to create transactions using Tasker.
Making Transactions From Text¶
To create a new transaction you just need to send broadcast intent. Since intent received the app analyze it and create new transaction using notifications detection algorithm.
Intent parameters are
Class = biz.interblitz.intent.CONVERT_TEXT_TO_NEW_TRANSACTION
Extras:
timestampMillis: Type of long, date and time of a new transaction in milliseconds. Current date and time used when empty.
address: Type of String, sender of the message, can be empty.
message: Type of String, message like a notification to create a new transaction, required.
REST API¶
Budget Blitz for Android supports REST API. API allows to create new directories and transactions, and edit or delete existed ones. Using this API you can create your own addons or applications.
You have to enable remote access to dial with REST API and read documentation, see chart Remote access. Documentation is available by Swagger. On the Swagger. page type the address http://[server]:[port]/api/v1/docs.json. Server and port will be available after PC connection enabled.
You can try app examples at the github.com. After an exmple has loaded type Budget Blitz for Android address as http://[server]:[port].
Intents API¶
In addition to simple API for making transactions from text Budget Blitz for Android supports extended Intents API. It consists of two parts, events and data requests. API based on the REST API. By default Intents API is OFF. You have to enable it selecting the part you need.
Intents API: Part 1, Events¶
When directories and transactions are saving events occurs. On the event Budget Blitz for Android sends Intent. You have to select target packages in the settings. Intent contains:
Action = {biz.interblitz.budget{free/pro}.api.event.ITEM_ONCHANGE
Extras:
collection - collection name that fires event
id - object id that fires event
When transaction is coming from notification import Extras contains
notification - notification text
address - notification address (phone number or package name)
amount - transaction amount
currency - transaction currency
To get more data you should send request Intent.
Intents API: Part 2, Requests¶
Request intents intended to get, modify or delete some data. Intent structure is
Class = biz.interblitz.service.ApiReceiver
Action = {biz.interblitz.budget{free/pro}.api.request
Extras:
method - single value from: GET, POST, DELETE
path - path to the collection
body - JSON data
package - full package name to receive response, response will not return if empty
class - package class to receive response, may be empty
Also Extras can contain any other data. All that data will returned back in response.
Budget Blitz for Android sends Intent response witt structure
Action = {biz.interblitz.budget{free/pro}.api.response
Extras:
collection - collection name
response - JSON response
Parameters method, path, body, collection, response matches REST API. Documentation is available from the Swagger. See more REST API.