https://github.com/zoho/zohocrm-php-sdk-5.0
https://github.com/zoho/zohocrm-php-sdk-5.0
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/zoho/zohocrm-php-sdk-5.0
- Owner: zoho
- License: apache-2.0
- Created: 2023-06-20T06:57:32.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-10-16T10:36:37.000Z (over 2 years ago)
- Last Synced: 2024-12-12T23:46:23.357Z (over 1 year ago)
- Language: PHP
- Size: 742 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Zoho CRM PHP SDK 5.0
The PHP SDK for Zoho CRM allows developers to easily create client PHP applications that can be integrated with Zoho CRM. This SDK serves as a wrapper for the REST APIs, making it easier to access and utilize the services of Zoho CRM.
Authentication to access the CRM APIs is done through OAuth2.0, and the authentication process is streamlined through the use of the PHP SDK. The grant and access/refresh tokens are generated and managed within the SDK code, eliminating the need for manual handling during data synchronization between Zoho CRM and the client application.
This repository includes the PHP SDK for API v5 of Zoho CRM. Check [Versions](https://github.com/zoho/zohocrm-php-sdk-5.0/releases) for more details on the versions of SDK released for this API version.
License
=======
Copyright (c) 2021, ZOHO CORPORATION PRIVATE LIMITED
All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
## Latest Version
- [3.0.0](/versions/3.0.0/README.md)
- Added new column(api_domain) in TokenStore.
- [2.1.0](/versions/2.1.0/README.md)
- Fixed an issue with the BulkWrite UploadFile API.
- [2.0.0](/versions/2.0.0/README.md)
- **Records API:** Fix to support delete operation for multi-select lookup, multi-user lookup, image upload, and subform fields.
- **Email-related records API:** API pagination fix to handle ***next_index*** and ***prev_index*** field datatype.
- **User-specific fields:** Resolved conflicts in the metaclass names of user-specific fields.
- [1.0.0](/versions/1.0.0/README.md)
- PHP SDK upgraded to support v5 APIs.
- PHP SDK improved to support the following new APIs
- [User Groups API](https://www.zoho.com/crm/developer/docs/api/v5/associated-user-count-user-group.html)
- [Fiscal Years](https://www.zoho.com/crm/developer/docs/api/v5/get-fiscal-year.html)
- [Timeline API](https://www.zoho.com/crm/developer/docs/api/v5/timeline-of-a-record.html)
- [Transfer and Delete Users](https://www.zoho.com/crm/developer/docs/api/v5/transfer_records-delete_user.html)
- [Territories](https://www.zoho.com/crm/developer/docs/api/v5/add-territories.html)
- [Territories Users](https://www.zoho.com/crm/developer/docs/api/v5/associate-users-territory.html)
For older versions, please [refer](https://github.com/zoho/zohocrm-php-sdk-5.0/releases).
## Including the SDK in your project
You can include the SDK to your project using Composer.
For installing the latest [version](https://github.com/zoho/zohocrm-php-sdk-5.0/releases/tag/3.0.0) of PHP SDK, navigate to the workspace of your client app and run the following command.
```sh
composer require zohocrm/php-sdk-5.0:3.0.0
```
With this, the PHP SDK will be installed and a package named vendor will be created in the workspace of your client app.
---
**NOTE**
> - The **access and refresh tokens are environment-specific and domain-specific**. When you handle various environments and domains such as **Production**, **Sandbox**, or **Developer** and **IN**, **CN**, **US**, **EU**, **JP**, or **AU**, respectively, you must use the access token and refresh token generated only in those respective environments and domains. The SDK throws an error, otherwise.
For example, if you generate the tokens for your Sandbox environment in the CN domain, you must use only those tokens for that domain and environment. You cannot use the tokens generated for a different environment or a domain.
> - For **Deal Contact Roles API and Records API**, you will need to provide the **ZohoCRM.settings.fields.ALL** scope along with the **ZohoCRM.modules.ALL** scope while generating the OAuthtoken. Otherwise, the system returns the **OAUTH-SCOPE-MISMATCH** error.
> - For **Related Records API**, the scopes required for generating OAuthtoken are **ZohoCRM.modules.ALL**, **ZohoCRM.settings.fields.ALL** and **ZohoCRM.settings.related_lists.ALL**. Otherwise, the system returns the **OAUTH-SCOPE-MISMATCH** error.
> - For **Mass Convert API**, you will need to provide the **ZohoCRM.settings.fields.ALL** scope along with the **ZohoCRM.mass_convert.leads.CREATE** and **ZohoCRM.mass_convert.leads.READ** scope while generating the OAuthtoken. Otherwise, the system returns the **OAUTH-SCOPE-MISMATCH** error.
---
For more details, kindly refer here. [here](/versions/3.0.0/README.md).