README
This document describes the make up of the Flood API.
Schema
The Flood API follows the Hypertext Application Language serialization format for responses, and accepts a standard ActiveModel style request body format for JSON requests, and form-data based requests for application/multipart.
Current Version
The current version of the API is v2, which is also accepted as the default version. We encourage you to explicitly specify the correct version:
Making requests
The Flood API server is https://api.flood.io
, you must use HTTPS for requests or your client will be redirected to the HTTPS version.
HTTP Verbs
Where possible, Flood API strives to use appropriate HTTP verbs for each action.
Verb | Description |
HEAD | Can be issued against any resource to get just the HTTP header info. |
GET | Used for retrieving resources. |
POST | Used for creating resources. |
PUT | Used for replacing resources or collections. For PUT requests with no body attribute, be sure to set the Content-Length header to zero. |
DELETE | Used for deleting resources. Will return a 204 with an empty body on success. |
Authentication
Flood API supports multiple authentication strategies, depending on how you're using the API.
Basic Token
The simplest way to authenticate is by using your API token, which can be found on your account page. Example:
OAuth 2
We also support OAuth2, which allows you to generate user tokens, or register an application to develop against and allow your own users to authenticate with their account. This is ideal if you're developing an application for release as a desktop or mobile app.
This feature is still in private beta, if you would like to request access, please email support@flood.io
End to End Example
Using your favourite CI build automation tool, you could execute a similar script as follows to launch and run flood tests:
Last updated