KopiCloud AD API»
The KopiCloud AD API is a REST API.
The API can be consumed by making API calls from:
Scripting languages such as PowerShell or Bash.
From the Swagger UI.
Using our Terraform Provider.
KopiCloud AD SDKs, which are currently under development.
What is a REST API?»
API is short for Application Programming Interface, a set of rules that lets programs talk to each other, exposing data and functionality in a consistent format.
REST stands for Representational State Transfer and is an architectural pattern that describes how distributed systems can expose a consistent interface.
When people use the term REST API, they are generally referring to an API accessed using the HTTP protocol at a predefined set of URLs.
These URLs represent various resources with one or more methods that can be performed on them over HTTP, like GET, POST, PUT, and DELETE.
GET requests data only – and does not modify it in any way.
DELETE delete the resources defined in the API method.
POST is used to create resources.
PUT is used to update resources.
API Response Codes»
REST APIs use the response codes to inform clients of their request's result.
The KopiCloud AD API will return the following API response codes:
|OK - Successful Request
|Bad Request - Unexpected Error
|Unauthorized - Invalid Credentials
|Forbidden - Access Denied
|Not Found - Object Not Found
By default, you need an Authentication Token to make API calls.
KopiCloud AD API supports two types of tokens: JWT Token, and Basic Token.
If your token is invalid or expired, the API call will fail, and you will receive a 401 response code.
You need to install a license of KopiCloud AD API before you can make API calls or use the Terraform Provider.
Get a free trial license here.
If your license is invalid or expired, the API call will fail, and you will receive a 403 response code.