The NitrAPI: Nitrado's programming interface for ordering, managing and controlling services

All Nitrado services can be easily controlled via the Nitrado web interface. For hobbyists, modders, and professional developers there's also another way: The Nitrado API (short NitrAPI) allows the control of arbitrary services automatically, for instance for ordering, cancelling, or embedding information into your own website.

We would like to offer you a deeper insight into Nitrado and in this article we will show you the interface that Nitrado itself uses to control all services - and that it can be used by every customer for your own services in the same way.

The NitrAPI briefly explained

"NitrAPI" stands for Nitrado Application Programming Interface. It is used by Nitrado to manage all of our hosted services. As an example, the web interface introduced in the last article is simply an application that uses the NitrAPI to display data and send commands to the servers. For instance, when a user clicks on a button for restarting the server, the web interface sends the appropriate command to the NitrAPI, which then executes the actual restart.

Nitrapi

Because Nitrado grants free access to the NitrAPI to everyone, hobbyists and professionals can create applications for their individual needs that mimic features of the web interface, or even order new servers when needed.

Open Source Libraries for Easy Use

The NitrAPI is an HTTP REST API authenticated via OAuth2, and therefore can be used with ease from a variety of different programming languages. To make usage even more convenient for developers, Nitrado provides libraries for different programming languages on our GitHub profile for everyone to dive in and use. Currently, there are already implementations available for PHP, Swift, and Java. Additionally, the release of a JavaScript library is planned for the near future.

That these libraries are published on GitHub also means that Nitrado gladly accepts feedback and pull requests from developers, who would like to contribute to the further development of these libraries.

For everyone who wants to build their very own library, a detailed documentation of all public interfaces is available at https://doc.nitrado.net.

 


Test your own applications on your Nitrado server!

Rent your own Nitrado server Today!


 

Usage Examples

Now which tasks can be realized with help of the NitrAPI? To make the options a bit more comprehensive, here are two examples for different use cases:

Automatic upgrades and downgrades for Cloud Servers

Most server applications are not evenly utilized at all times. Usually, clear usage patterns can be established, for example, increased load during after hours, the weekend, or at certain events. For these times of high load, significant computing power is necessary, which is not utilized during the rest of the time and therefore results in unnecessary costs.

The NitrAPI allows it to automatically add and remove resources to and from Cloud Servers. That means it's possible to develop a script that monitors a server's utilization and automatically books additional resources when needed. This feature is used best with Nitrado's "Cloud Server Dynamic", which allows subsequent downgrades without additional cost.

Modding

Since the NitrAPI can be used with almost any programming language, it can also be used within almost any game modification. For instance, many communities use a game server as well as accompanying voice server - and maybe uninvited guests aren't wanted on either of them. In this case, the game server, as well as the voice server, have to be protected separately.

Since it's also possible to use features of voice servers like TeamSpeak and Mumble through the NitrAPI, a game modification could be employed to automatically grant access to the voice server to players who join the server (and therefore know its password or can be found on the whitelist). For Mumble this would be possible by automatically creating a new server user, and with TeamSpeak, a "Privilege Token" could be generated and displayed to the player, which they can use to move freely on the voice server. That means: Whoever has access to the game server also has access to the voice server, and the management of two different protection mechanisms is a thing of the past.

Other, arbitrary commands can be embedded into games in a similar fashion. For demonstration purposes we have published a simple Minecraft plugin on our GitHub profile. It is able to forward a number of commands from the game's in-game console to the NitrAPI, notably for creating and restoring backups of the game world from within the game.

Conclusion

The NitrAPI is a publicly available interface that allows developers to create custom applications for their Nitrado services and to automate processes. Nitrado is already looking forward to suggestions and requests for the extension of this interface, to support hobby developers and professionals with all features they need for the implementation of their projects.

 

You enjoyed the little insight into our NitrAPI? Then write us a comment on social media or in our news, if you want to see more insights behind Nitrado.
We are happy to receive your comments!

Feb 6, 07:25 pm
2747
1
Zachary Smith
Your reaction

2

0

0

0

0

3

0
Comments
  
krisjelly2
43 Days
Hello :) Is there a way to access to ShooterGame.Log Api there is no option on the Nitrado.net API Documentation website