Skip to content

pynch-tv/Nexa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 

Repository files navigation

Nexa OpenAPI

Automate your AudioVideo servers through a unified API

Untitled

Nexa provides an HTTP RESTful OpenAPI on top of existing audio video production servers - made for the broadcast integrators and programmers.


Running into issues? Check out the wiki first!

The main raison to have this GitHub repo is the ability for you to report issues (and for others to see/learn from the issues). Before you raise an issue, make sure you look at the common issues wiki

OpenAPI

We want the API to be instantly recognizable by programmers and broadcast engineers! How? By applying all the industry best-practices and API guidelines put forward by industry: W3C, IETF, OGC, industry best practices and government API Design Rules.

By following the well-known API patterns, developers can get their first successful call within minutes TTFC (The time taken between a developer accessing documentation, and/or signing up for an API key and making their first successful API call (of any complexity)). Additionally, by following the best practices, AI coding assistants (eg GitHub's Co-Pilot) can predict code more easely and accuratly.

Screenshot 2024-06-05 at 11 46 12

API for machines and humans

Nexa can render the same information in 2 ways: as JSON (for machine consumption) and in HTML (for human consumption).

A side-by-side comparison between HTML and JSON respectively:

296444185-9881eea4-7527-44ab-838c-526b91a8b9f2

The one on the left (HTML) is called with http://localhost:8080/acme/unit11/v1/ and the one on the right (JSON) with http://localhost:8080/acme/unit11/v1/?f=json (see the difference?).

Installation

Nexa comes as an offline installer (that makes it slightly larger) that does not require an internet connection. Typically production server are not exposed to the internet, for security (and other) reasons. The installer is self contained and will only install what is really needed. The installer does not mess with the Windows Registry, nor with any other settings that might affect the behaviour of running applications.

Nexa must be installed in the network that is used by the servers. More on the installation process here.