webleit / zohosignapi
Zoho Sign API - PHP SDK
Requires
- php: >=7.0.0
- doctrine/inflector: ^1.3
- guzzlehttp/guzzle: ~6.0
- psr/cache: ^1.0
- tightenco/collect: ^5.7
Requires (Dev)
- phpunit/phpunit: 7.*
This package is auto-updated.
Last update: 2022-08-25 02:54:48 UTC
README
This Library is a SDK in PHP that simplifies the usage of the Zoho Sign Api version 1 (https://www.zoho.com/sign/api/) 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
composer require webleit/zohosignapi
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 sign apis.
require './vendor/autoload.php'; $zohoSign = new ZohoSign('[CLIENT_ID]', '[CLIENT_SECRET]', '[REFRESH_TOKEN]');
Authentication
Zoho Sign Api use oAuth2 as the authentication method, as described here. In order to authenticate the library, you can use two different methods:
1. Refresh Token
If you want to, you can skip steps 1-7 and directly use Step 8, but you need to generate the refresh token yourself manually, using the instruction provided by zoho: https://www.zoho.com/sign/api/#getting-started
$zohoSign = new ZohoSign('[CLIENT_ID]', '[CLIENT_SECRET]', '[REFRESH_TOKEN]');
2. Grant Token / Authorization Page
This is the best way, even if it requires more work.
-
Go to [https://accounts.zoho.com/developerconsole] (https://accounts.zoho.com/developerconsole)
-
Create a Client Id. Remember the redirect url you set, you will need it
-
Use the library to create a Grant token Url, and create a page (probably for the web application administrator?) that redirects to the given url, to allow the user to authenticate with his zoho sign credentials.
use \Webleit\ZohoSignApi\ZohoSign; $zohoSign = new ZohoSign('[CLIENT_ID]', '[CLIENT_SECRET]'); $redirectUrl = $zohoSign->getGrantCodeConsentUrl('[YOUR_REDIRECT_URI]'); // Redirect your user here to $redirectUrl
-
In your web application, create an endpoind for the redirect url you set in step 2.
-
When a request comes in to the new endpoint at
[REDIRECT_URL]
, you can use the library to parse the grant token from the url... $grantToken = \Webleit\ZohoSignApi\ZohoSign::parseGrantTokenFromUrl($fullUri); // or, alternatively, $grantToken = $_GET['code']; ...
-
Give the Grant Code to the library
$zohoSign = new ZohoSign('[CLIENT_ID]', '[CLIENT_SECRET]'); $zohoSign->setGrantCode($grantToken);
-
Get the fresh token, and store it.
$refreshToken = $zohoSign->getRefreshToken();
-
From now on, use the refresh Token to create the library instance
$zohoSign = new ZohoSign('[CLIENT_ID]', '[CLIENT_SECRET]', $refreshToken);
Usage
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
Example
$zohoSign = new ZohoSign('[CLIENT_ID]', '[CLIENT_SECRET]', '[REFRESH_TOKEN]'); $requests = $zohoSign->requests->getList();
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
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.