newhazedevelopers

Introduction

The NewHaze OpenAPI is a read-only API library designed for people who don't want to build a games site using the NewHaze service. For this reason, it uses global IDs rather than assigning local IDs for your own site. You can get all public data for objects, without site localization.

The OpenAPI is optimized for people who want to build tools to offer other developers. Please share the tools you plan on building with us, and we can help you out with it a bit!

How to connect

You can connect to the OpenAPI by simply sending requests to:

http://connect.newhaze.com/openapi/

The response is sent as JSON.

To access a particular method, you simply add to the end of the URL. For example, for all the comments on the game Snake, you would send a request to:

http://connect.newhaze.com/openapi/games/3904/comments/

The objects you can access, and all methods associated to those objects are outlined in this documentation.

Objects

• Sites
• Games
• Developers
• URL

We aim to add more objects to the site as soon as possible.

Selecting Data

When using the OpenAPI, by adding query parameters to the end of the URL, you can adjust what data and how much you want to receive. Parameters you can use are:

• limit: the maximum number of results to display
• offset: offset the first result (used for pagination)
• until: the latest date to retrieve information for (either as strtotime format or timestamp format)
• since: the earliest date to retrieve information for (either as strtotime format or timestamp format)
• ids: a comma-delimited list of IDs to get information for
• fields: only return certain information for the results
• query: search results using a search term
• info: boolean (1 or 0) on whether or not to return number of results and execution time