The BB2 API is a RESTful interface for accessing and modifying your account.It supports both XML and JSON and a ruby library will be provided to help build client functionality.
Authentication at launch will be using token authentication. The api_key for the user will be found at https://account_name.batchbook.com/preferences The api_key must be passed as a query parameter with the key "auth_token". For example. https://apitest.batchbook.com/api/v1/people.json?auth_token=GR5doLv88FrnLyLGIwok
There has been some work done on implementing oauth2 but it isn't complete at launch. If you feel this would make things easier for your integration please let us know.
If you would like to quickly test some code against the api, you can use our open apitest account at apitest.batchbook.com. If you would like a personal account to test your integration against please write in to email@example.com. If you'd like to see how the data is rendering in batchbook you can go to https://apitest.batchbook.com/?auth_token=mXZ8syJrMYHzcxf8j83D
The apitest account has 4 users to use for testing.