Download the PHP package rams007/zohobooksapi without Composer
On this page you can find all versions of the php package rams007/zohobooksapi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package zohobooksapi
Zoho Books API v3 - PHP SDK
This Library is a SDK in PHP that simplifies the usage of the Zoho Books Api version 3 (https://www.zoho.com/books/api/v3/) It provides both an interface to ease the interaction with the APIs without bothering with the actual REST request, while packaging the various responses using very simple Model classes that can be then uses with any other library or framework.
Installation
Usage
In order to use the library, just require the composer autoload file, and then fire up the library itself. In order for the library to work, you need to be authenticated with the zoho apis.
Online Mode
Offline Mode
This one is preferred when you need to autonomously renew the access token yourself. Used in all the "machine to machine" communication, and it's the best way when you are using the apis to, for example, sync with a 3rd party application, like your ERP or Ecommerce website. See https://github.com/Weble/ZohoClient#example-usage-offline-mode for more details on this.
API calls
To call any Api, just use the same name reported in the api docs. You can get the list of supported apis using the getAvailableModules() method
You can, for example, get the list of invoices by using:
or the list of contacts
List calls
To get a list of resources from a module, use the getList() method
It's possible to pass through some parameters to filter the result (see the zoho books api docs for some examples)
In order to navigate the pages, just use the "page" and "per_page" parameters in the getList call
Return Types
Any "list" api call returns a Collection object, which is taken for Laravel Collection package. You can therefore use the result as Collection, which allows mapping, reducing, serializing, etc
Any "resource" api call returns a Model object of a class dedicated to the single resource you're fetching. For example, calling
will return a \Webleit\ZohoBooksApi\Models\Invoice object, which is Arrayable and Jsonable, and that can be therefore used in many ways.
Zoho Books token expiration notes
- Each access token is valid for only an hour and used only for the operations defined in the scope.
- Refresh token does not expire. Use it to refresh access tokens when they expire.
- You can only generate a maximum of five refresh tokens in a minute.
Contributing
Finding bugs, sending pull requests or improving the docs - any contribution is welcome and highly appreciated
Versioning
Semantic Versioning Specification (SemVer) is used.
Copyright and License
Copyright Weble Srl under the MIT license.
All versions of zohobooksapi with dependencies
guzzlehttp/guzzle Version ^6.0 || ^7.0
doctrine/inflector Version ^2.0
illuminate/collections Version ^v8.0 || ^9.0 || ^10.0 || ^11.0
weble/zohoclient Version ^4.2
ext-json Version *