REST API: Introduction
The WPCloudDeploy REST API is an ongoing project that will eventually consist of several hundred end points.
The first few endpoints will be production-ready starting with WPCD Version 4.14.0.
The REST API uses the standard http verbs:
- GET: List things such as servers and sites
- PUT: Change things such as toggle SSL
- DELETE: Delete things such as servers and sites
- POST: Create things.
The API is protected by basic HTTP authentication.
You can create HTTP Authentication credentials using the WordPress APPLICATION PASSWORDS function. The RESTAPI will only allow users with the the ADMIN or WPCDAdmin roles. All other users will get an authentication error.
Documentation on all endpoints is located here: WPCD REST API Endpoints
The current endpoints allow you to create new servers and sites, delete those servers and sites, list servers and sites, toggle SSL and clone and change domain for a site.
Enabling The REST API
The API is disabled by default. You need to explicitly turn it on before you can use it.
- Navigate to WPCLOUDDEPLOY->SETTINGS->APP:WORDPRESS SETTINGS->REST API
- Activate the checkbox
- Click the SAVE SETTINGS button at the bottom of the screen.
Technical Support
The WPCloudDeploy REST API is available to everyone including Core subscribers and Github users. However, support is only available to All Access subscribers and Lifetime license holders.
Technical support is limited to bug reports only.
Because the REST API is, by definition, a tool to be used by developers, we are unable to offer free support beyond handling bug reports or suggestions for improving documentation. Otherwise we’d be spending an enormous amount of time just debugging customized code for free.
However, a Developer Support contract is available for purchase that will allow for more in-depth consultative support. Just contact us and we’ll create one for you.
Example Application
Below are some screen shots from a no-code application (i.e.: an application that is not WordPress) that uses the REST API. This is a sample application that we have created to stress-test the endpoints.
