Newgrounds Flash API: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 4: Line 4:
'''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.
'''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.
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 ==
== API Versions ==
Line 37: Line 43:
* '''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 per game. There is no universal file like v1 or v2.
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 ==
* 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.

Revision as of 18:36, 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.

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

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

Retrieved from "https://flashpointarchive.org/w/index.php?title=Newgrounds_Flash_API&oldid=11360"