Introduction

Welcome to the Eagle Eye Networks REST API v3, the fully redesigned and improved API for the Eagle Eye Video API Platform. The Eagle Eye Video API Platform is the cloud behind the Eagle Eye Cloud VMS product.

The Eagle Eye Video API is a comprehensive RESTful API for recording, indexing, and storing camera video. It handles all the heavy lifting of interfacing with the cameras, recording video, securely transmitting video to the cloud, storing video, and making video available for use by your applications.

This guide will walk you through your first steps to help you get started.

Get an account

Before you begin your integration with the Eagle Eye Video API Platform, you need an account for development and testing.

If you already have an account, use it. Otherwise, you can create a new one here

Tip: Consider enhancing your development experience with our Developer Hardware Kit, offered at a significant discount for developers. The kit includes an Eagle Eye bridge and multiple cameras, perfect for testing your integration. For further details, reach out to us at [email protected].

Get the Client Credentials (API Key)

Eagle Eye Networks simplifies the authentication and authorization process using the OAuth framework. For each API client, you need a unique set of Client Credentials, which include a client ID and a client secret.

Create your Client Credentials in the My Application section to get started with our REST API v3.

Eagle Eye Networks exclusively supports the OAuth Authorization Code grant type, which necessitates specifying redirect URLs. For your security, only whitelisted redirect URLs are permitted. During development, you can conveniently use localhost (e.g., http://127.0.0.1:3333).

🚧

Important

The redirect URL must exactly match the example (http://127.0.0.1:3333). Since whitelist checking is based on string comparison, any other forms like <https://127.0.0.1:3333> or <http://localhost:3333> or 127.0.0.1:3333/ will not work.

OAuth defines two types of clients: confidential clients and public clients.

• Confidential clients are applications that are able to securely authenticate with the authorization server, keeping their registered client secret safe.
• Public clients are unable to use registered client secret, such as applications running in a browser. You can opt for either one depending on your application while creating your client credential.

🚧

Important

Eagle Eye Networks REST API v3 uses a new OAuth-based authentication method and therefore you have to request new Client Credentials for all your applications. You can no longer use the existing API V2 keys configured in the Eagle Eye Cloud VMS.

CORS domain whitelisting

Cross-origin resource sharing, or CORS, is a browser security feature that establishes rules for cross-origin requests. It is implemented in all modern web browsers, and requires that the remote site allows cross-origin requests to specific resources. Eagle Eye Networks implements a whitelist system that allows blocking all requests except for the ones from known technology partners.

Please reach out to [email protected] to whitelist your domain.

Start integration

You are now ready to start integrating. Go to Login, for example, and follow the instructions from there.

If you do not find answers to your questions in our guides or our FAQ, do not hesitate to reach out to us at [email protected]. We're here to assist you!