API Shell for WHM
Overview
This feature allows you to call WHM API functions interactively within the interface. To enable this feature, you must enable the cPanel & WHM API shell (for developers) setting in WHM’s Tweak Settings interface (WHM >> Home >> Server Configuration>> Tweak Settings).
Warning:
This feature uses live data from your server. API function calls may change or delete data on your server, which can cause your server to fail. Read each function’s documentation thoroughly before you use it in the API Shell interface, a script, or through any other method.
Note:
Only the root user and root-enabled resellers may use this feature.
Call a WHM API 1 function
To call a WHM API function, perform the following steps:
- Select a version of the WHM API.
Note:
- Only WHM API version 1 is available through this interface.
- To learn more about each function, click WHM API v1 Documentation.
- To select the first record to show from the results, enter a number in the Index (0-based) of first result to show text box.
- To limit the number of results that the interface displays, enter the maximum number of results to display in the Maximum # of results to show text box.
- To filter the results:
- Click Add in the Filters section.
- Enter the appropriate information in the Field text box, condition menu, and Term text box.
- To enter more filters, click Add.
- Click Add in the Sorts section of the interface.
- Enter the appropriate information in the Field text box and condition menu.
- Select the Reverse checkbox if you want to reverse the sort order.
- To enter more sort methods, click Add.
- Click Add in the Columns section of the interface.
- Enter the appropriate information in the Column text box.
- To enter more columns to display, click Add.
API call results
The system displays the results in the API call response section of the interface. You can view the results in the Tree view, Table view, or Raw view tabs.
Note:
The Raw view tab’s response separates the function call’s response from the HTTP headers.