Accessing the API
Create HTTP requests in the following format:
https://<ipaddress>/fpc/v1/api/<resources>
Headers
Each request must contain the following HTTP header fields:
- Content-type: application/json
- Authorization: Token <API_key>
The Authorization header is mandatory in all API calls.
See
URL parameters
FortiPortal API follows the standard REST format for the request URLs.
In a request to get all entries of a collection, or to add a new entry to a collection, the URL includes the collection name.
In a request to get, update or delete a specific member of a collection, the URL includes the collection name and the index of the specific entry. For a nested collection (such as organization sites), the URL may contain more than one index (one for organization ID, one for site ID).
The URL parameters are always mandatory. If you do not provide a valid ID for each index in the request URL, the request will result in a failure response.
JSON payload parameters
In the methods to add a new entry or update an existing entry in a collection, the payload contains the input fields for the entry. The payload information is sent as text in JSON format.
Some input fields are required, and some are optional. You must provide values for the required fields. The API reference lists the required and optional fields for each API method.
Success response structure
API returns the following values in a successful response message:
- HTTP status 200
- Optionally, a JSON string depending on the API method.
Failure response structure
API returns the following values in a failure response message:
- HTTP status 4xx or 500
- A JSON string with the error details