# REST API Settings

The REST APIs provided by OvenMediaEngine allow you to query or change settings such as `<VirtualHost>` and `<Application>/<Stream>`.

## API Server Port Settings

<figure><img src="https://content.gitbook.com/content/xo7moYXTh3yBG01Dy49w/blobs/Dh2XGNqrXIZNOQISkw9j/image.png" alt=""><figcaption><p>In the Bind of the REST API Settings</p></figcaption></figure>

By default, the OvenMediaEngine API Server is disabled, so to use the API, you need to enable the feature by clicking the toggle button on the right side of the REST API Settings page. You can also review and modify the `Port` and Configuration for the REST APIs used by each `Application` on that page.

* `Port`: The Port that the server will use to receive HTTP requests
* `TLS Port`: Data is encrypted using the Transport Layer Security (TLS) Protocol between the web browser and the server. The encrypted data is transmitted over the Port.
* `Worker Count`: Sets the number of threads to use for data processing.

## Managers Settings

<figure><img src="https://content.gitbook.com/content/xo7moYXTh3yBG01Dy49w/blobs/BRIHbgyZdYd9gjN4KZ4A/image.png" alt=""><figcaption><p>In the Managers of the REST API Settings</p></figcaption></figure>

* `Name`: Enter the `Domain` or `IP` that can access the API Server.
  * *<mark style="color:blue;">You can add multiple Domains or IPs by clicking the</mark> <mark style="color:blue;"></mark><mark style="color:blue;">`+`</mark> <mark style="color:blue;"></mark><mark style="color:blue;">button on the right.</mark>*

### TLS Settings | 0.14.0.0+

* `Cert Path`: Shows the name and path of the `.crt` file that composes the TLS certificate.
* `Chain Cert Path`: Shows the name and path of the `.ca-bundle` file that constitutes the TLS certificate.
* `Key Path`: Shows the name and path of the `.key` file that composes the TLS certificate.

### API Settings

* `Access Token`:  Access Token is used to authenticate a client using the basic HTTP authentication scheme.
  * *<mark style="color:blue;">Although RFC7617 format is not required, you can easily pass the authentication in a standard browser by setting the Access Token in the</mark> <mark style="color:blue;"></mark><mark style="color:blue;">`user-id:password`</mark> <mark style="color:blue;"></mark><mark style="color:blue;">format.</mark>*
* `Cross Domains`: Most browsers and players prohibit accessing other domain resources in the currently running domain. You can control this situation via this option.

{% hint style="info" %}
Detailed Guide: <https://airensoft.gitbook.io/ovenmediaengine/rest-api>
{% endhint %}

### [API Storage](https://ovenmediaengine-enterprise.gitbook.io/guide/features/operations-and-monitoring/api-storage) Settings | 0.17.0.0+

* `Enabled`: Sets can enable or disable `Storage`.
* `Path`: Specifies the path where API information will be stored.