API Documentation (REST API)
Product: NEXTMEGABYTE (Greenitco ITAM) · Module: API Documentation · Audience: Developer, Administrator
The NEXTMEGABYTE REST API lets other systems and the mobile app work with tickets, service requests, devices, maintenance, procurement, change requests, knowledge documents and more. Use it to integrate monitoring tools, HR systems, websites, chatbots and custom applications.
Base URL
All endpoints are relative to your organization's portal address:
https://your-domain.com/api/...Replace your-domain.com with your portal URL.
Authentication
- Call the Login API (
POST /api/login) with the user's email and password. - The response returns the user's profile, roles, permissions and an
access_token. - Send the token in the
tokenheader of every other request, together with the application token.
Standard request headers
| Header | Value |
|---|---|
Content-Type |
application/x-www-form-urlencoded (the login API uses application/json) |
apptoken |
The application token issued for your portal |
token |
The user's access_token from the login API |
Keep tokens secret. Do not put access tokens or app tokens in client-side code or public repositories.
Response format
Responses are JSON. Most responses include:
| Field | Meaning |
|---|---|
status |
success or an error status |
msg |
A message describing the result |
data |
The returned record or records (list endpoints may also return total, filtered and paging fields) |
Permissions apply to the API in the same way as in the portal: the user can only read or change what their role allows.
API groups
| Group | Covers |
|---|---|
| Authentication | Login, forgot password, push (FCM) token, enabled modules, app version, Azure data, language |
| Tickets | List, details, create, edit, update status, assign, self-assign, transfer, change creator, star, spam, tags, filters, configuration |
| Service Requests | List, details, approval, forms, filters, revoke |
| Devices | Device info, check-in, check-out, audit, status labels, lists, asset owners, currencies, restore, receive |
| Scheduled Maintenance | Assigned plans, plan details, task updates, plan status, attachments |
| Procurement | Procurement lists, details, items, status, PAB, create |
| Change Requests | Change request list, details and approval |
| Knowledge Documents | Articles, categories and tags |
| Profile and Settings | Profile details and settings |
| Self-Service | My items, status board, requestable devices and device requests |
| Dashboard | Admin, technician and user dashboards |
| Problem Management | Problem lists and solving problems |