HTTP requests

Prev Next

The API is the intermediary between IXM One and the web server. When you use the API, you initiate an API call that tells IXM One to do something. IXM One, in turn, uses the API to ask the web server to do something.

The API call that you make is essentially an HTTP request that allows you to either access a resource on the server or to send data to the server.

HTTP methods

The HTTP method is a command that tells the server what to do. You can use the following HTTP methods in your requests to the API:

HTTP method

Description

GET

Retrieve a single item or a list of items.

POST

Create an item.

PUT

Update an item.

DELETE

Delete an item.

Header parameters

Your requests to the API must contain header parameters. Specifying these parameters allows you to transmit additional information for security, such as the API key or session ID for authorization.

Path parameters

Your requests also contain path parameters. Path parameters are variable parts of a URL that point to a specific resource. A URL can contain multiple path parameters, such as an API version or the unique ID of an item.

URL

The URL consists of at least a base API endpoint, followed by the API version and the plural name of the resource.

Example:

HTTP request

GET /v{version}/Spots

URL

https://api.grassfish.tv/v1.15/Spots

Depending on the request, more parameters can be added to the URL, such as IDs and names of resources and child resources.

Example:

HTTP request

GET /v{version}/PlaylistVersions/{playlistVersionId}/Items/{itemId}

URL

https://api.grassfish.tv/v1.15/PlaylistVersions/23787/Items/65243