Newgrounds Flash API

Newgrounds HTTP API Versions

Overview

Newgrounds is a large Flash-based content platform that historically provided multiple HTTP Web API versions to support online game functionality, including scoreboards and medals. Over time, these APIs evolved to accommodate new features and architectural changes.

This article documents the known API versions and their usage within the Flashpoint.

TL;DR:

• v1 and v2 API endpoints are routed through the legacy router as part of the standard Flashpoint installation.

• v3 requires per-game configuration.

API Versions

v1 API

• Endpoint: www.ngads.com/gateway.php
• Protocol: HTTP
• Purpose: Early implementation. Does not updating.

This endpoint is implemented in the legacy router:

• Repository Location:

 Legacy/cgi-bin/www.ngads.com/gateway.php

• Source:

 https://gitlab.unstable.life/flashpoint/components/core/legacy-router/-/blob/main/Legacy/cgi-bin/www.ngads.com/gateway.php?ref_type=heads

v2 API

• Endpoint: www.ngads.com/gateway_v2.php
• Protocol: HTTP
• Purpose: Revised version of the API with expanded functionality supporting per game implementation

This endpoint is implemented in the legacy router:

• Repository Location:

 Legacy/cgi-bin/www.ngads.com/gateway_v2.php

• Source:

 https://gitlab.unstable.life/flashpoint/components/core/legacy-router/-/blob/main/Legacy/cgi-bin/www.ngads.com/gateway_v2.php?ref_type=heads

v3 API

• Endpoint: www.newgrounds.io/gateway_v3.php
• Protocol: HTTP
• Purpose: New modernized API. This API is documented on Newgrounds website: https://www.newgrounds.io/help/components

Each game uses a unique Application ID, and the corresponding gateway_v3.php must be created per game. There is no universal file like v1 or v2