The API Bundle empowers integration developers to seamlessly interact with the UVDesk Community Helpdesk system using its robust RESTful API. It provides a comprehensive set of endpoints that allow external applications to perform key operations—such as creating, updating, and retrieving tickets, managing customers and agents and smooth integration with third-party platforms and custom systems.
This bundle can be easily integrated into any symfony application (though it is recommended that you're using Symfony 4 as things have changed drastically with the newer Symfony versions). Before continuing, make sure that you're using PHP 8.1 or higher and have Composer installed.
To require the api bundle into your symfony project, simply run the following from your project root:
$ composer require uvdesk/api-bundle
After installing api bundle run the below command:
$ php bin/console doctrine:schema:update --force
Finally clear your project cache by below command(write prod if running in production environment i.e --env prod):
$ php bin/console cache:clear --env dev
Use the below available apis to interact with your helpdesk system.
-
POST /api/v1/session/login
Authenticate user credentials and generate an access token in response to access helpdesk apis as the authenticated user.
Headers:
{ "Authorization": "Bearer AUTH_TOKEN" }To generate the required auth token, simply encode the user's email and password separated by a colon in base64 format, i.e. base64_encode("email:password").
Sample Response:
{ "success": true, "accessToken": "VBGLASXENR..." } -
POST /api/v1/session/logout
Invalidates an authenticated user access token so that it can't be used anymore.
Headers:
{ "Authorization": "Bearer ACCESS_TOKEN" }ACCESS_TOKEN: The api access token that was generated either using the session login api or directly from the dashboard.
Sample Response:
{ "status": true, "message": "Session token has been expired successfully." }
More examples of ticket related apis can be found over here.
-
GET /tickets
Get a collection of all user accessible tickets.
Headers:
{ "Authorization": "Bearer ACCESS_TOKEN" }ACCESS_TOKEN: The api access token that was generated either using the session login api or directly from the dashboard.
Sample Response:
{ "tickets": [ { "id": 1, "subject": "Support Request ...", "isCustomerView": false, "status": { "id": 1, "code": "open", "description": "Open", "colorCode": "#0056fc", "sortOrder": 1 }, "group": null, "type": { "id": 1, "code": "support", "description": "Support", "isActive": true }, "priority": { "id": 1, "code": "low", "description": "Low", "colorCode": "#2DD051" }, "formatedCreatedAt": "16-05-2023 12:55pm", "totalThreads": "0", "agent": { "id": 1, "email": "[email protected]", "name": "Sample Agent", "firstName": "Sample", "lastName": "Agent", "isEnabled": true, "profileImagePath": null, "smallThumbnail": null, "isActive": true, "isVerified": true, "designation": null, "contactNumber": null, "signature": null, "ticketAccessLevel": null }, "customer": { "id": 2, "email": "[email protected]", "name": "Sample Customer", "firstName": "Sample", "lastName": "Customer", "contactNumber": null, "profileImagePath": null, "smallThumbnail": null } } ], "pagination": { "last": 1, "current": 1, "numItemsPerPage": 15, "first": 1, "pageCount": 1, "totalCount": 1, "pageRange": 1, "startPage": 1, "endPage": 1, "pagesInRange": [ 1 ], "firstPageInRange": 1, "lastPageInRange": 1, "currentItemCount": 1, "firstItemNumber": 1, "lastItemNumber": 1, "url": "#page/replacePage" }, "userDetails": { "user": 1, "name": "Sample Agent" }, "agents": [ { "id": 1, "udId": 1, "email": "[email protected]", "name": "Sample Agent", "smallThumbnail": null } ], "status": [ { "id": 1, "code": "open", "description": "Open", "colorCode": "#0056fc", "sortOrder": 1 }, { "id": 2, "code": "pending", "description": "Pending", "colorCode": "#FF6A6B", "sortOrder": 2 }, { "id": 3, "code": "answered", "description": "Answered", "colorCode": "#FFDE00", "sortOrder": 3 }, { "id": 4, "code": "resolved", "description": "Resolved", "colorCode": "#2CD651", "sortOrder": 4 }, { "id": 5, "code": "closed", "description": "Closed", "colorCode": "#767676", "sortOrder": 5 }, { "id": 6, "code": "spam", "description": "Spam", "colorCode": "#00A1F2", "sortOrder": 6 } ], "group": [ { "id": 1, "name": "Default" } ], "team": [], "priority": [ { "id": 1, "code": "low", "description": "Low", "colorCode": "#2DD051" }, { "id": 2, "code": "medium", "description": "Medium", "colorCode": "#F5D02A" }, { "id": 3, "code": "high", "description": "High", "colorCode": "#FA8B3C" }, { "id": 4, "code": "urgent", "description": "Urgent", "colorCode": "#FF6565" } ], "type": [ { "id": 1, "name": "support" } ], "source": { "email": "Email", "website": "Website" } }
The API Bundle and libraries included within the bundle are released under released under the OSL-3.0 license