> For the complete documentation index, see [llms.txt](https://docs.giraffecctv.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giraffecctv.com/cloud/api/http-api.md).

# HTTP API

Use Giraffe's HTTP APIs to connect your own applications to cameras, systems, events and recordings. The interactive API documentation includes available operations, request parameters, response formats and authentication instructions.

## Open the API documentation

Open [api.onvp.io/docs](https://api.onvp.io/docs/) directly, or access it from Giraffe Cloud:

1. Open your user menu in the top right. On smaller screens, open the navigation menu.
2. Under **Resources**, select **API documentation**. The documentation opens in a new tab.
3. Select the API you want to use.

<figure><img src="https://2701567920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZS3YRsoEs7DBwWBJpaD%2Fuploads%2Fgit-blob-069a820776b82e480b799b48922e4907647830c7%2Fcloud-api-documentation-menu.jpg?alt=media" alt="Resources section of the Giraffe Cloud navigation menu with the API documentation link" width="283"><figcaption><p>Open API documentation from the menu. The small-screen layout is shown here.</p></figcaption></figure>

{% hint style="info" %}
Currently, you must be signed in to Giraffe Cloud in the same browser to view the API documentation.
{% endhint %}

## Choose the right reference

Start with **ONVP Public API v2** for cloud integrations. The catalogue also includes the **Edge Controller API**, **Audio Proxy API** and **RTSP Proxy API**. See the [API overview](/cloud/api.md#what-you-can-integrate) for what each can help you build.

Where the reference offers a version or environment, choose the one that matches your integration. For the Edge Controller API, select the version that matches the controller's firmware. Use the reference for each API's connection details, supported operations and authentication requirements.

## Make your first request

For the public HTTP API, [create a personal access token](/cloud/api/api-keys.md), then follow **Getting started with personal access tokens** in the [public API reference](https://api.onvp.io/docs/api-v2). This explains how to select a team and make a first request. Signing in to read the documentation does not authenticate your integration.

{% hint style="warning" %}
Requests sent from the interactive documentation can affect real systems. Check the selected environment, system and operation before sending a request.
{% endhint %}
