• about 'nu'Learn more about VGA Planets "Nu"
  • the projectAbout the VGA Planets "Nu" project, the official web based remake of VGA Planets.
  • contactContact the VGA Planets "Nu" team.
VGA Planets
YEAR: 001717th year of the first Emperor war
  • HomeVGA Planets is a space strategy game that became the largest play by email game ever created. VGA Planets Nu is the new 2010 web edition of this classic turn-based game, originally launched in 1992.
  • My Games
  • Join GameThe Echo Cluster
  • News and EventsBlog posts, recent posts and player events.
  • LeaderboardView the top players in the VGA Planets Nu community.
  • ForumsVGA Planets discussion forums.
  • FeedbackSend us suggestions and report bugs here on our UserVoice.
  • How to PlayVGA Planets "Nu" documentation.
  • UpgradeSign up for VGA Planets Nu and start playing the greatest space strategy game ever created.
  • Sign In
Edit - Delete
Text AreaText Area - New Text Area
API Table of Contents
Edit - Delete
Text AreaText Area - Login API

Login API

The login API returns an API key which can be used along with a username for subsequent API calls.

To use the login command HTTP POST to http://api.planets.nu/login with the following form values:

  • username=account username
  • password=account password

If the credentials are correct you will receive a an API Key like:

f74b9f96-f89a-4cfe-813f-5f86df1cb37f

You can now use this key for subsequent API calls for this account. This is the API Key of the account and will only change if the user changes their account password.

For all API calls, if you are not authorized or experience an error you will receive a response which begins with the word error followed by a colon and an error message like so:

Error: Invalid username or password.


Follow VGA Planets on Twitter Play Planets on Facebook!
© Copyright 2010 Geographical Media Inc.
 About Planets Nu - Contact Us - Site Rules - API