Newgrounds Flash API: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
(Created page with "= 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 ecosystem. == API Versions == === v1 API === * '''Endpoint:''' <cod...")
 
mNo edit summary
Line 37: Line 37:
* '''Purpose:''' New modernized API
* '''Purpose:''' New modernized API


Each game uses a unique '''Application ID''', and the corresponding <code>gateway_v3.php</code> must be created or configured individually for each title.
Each game uses a unique '''Application ID''', and the corresponding <code>gateway_v3.php</code> must be created per game. There is no universal file like v1 or v2.


== Implementation Notes ==
== Implementation Notes ==
* v1 and v2 endpoints are routed through the legacy router as part of the standard Flashpoint installation.
* v1 and v2 endpoints are routed through the legacy router as part of the standard Flashpoint installation.
* v3 requires per-game setup due to its application-specific authentication model.
* v3 requires per-game setup due to its application-specific authentication model.

Revision as of 18:35, 14 February 2026

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 ecosystem.

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

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.

Implementation Notes

  • v1 and v2 endpoints are routed through the legacy router as part of the standard Flashpoint installation.
  • v3 requires per-game setup due to its application-specific authentication model.