GAME INTEGRATION GUIDE
Magic Chess
ID Checker API
Look up a Magic Chess: Go Go account using its player ID and zone ID.
What you need
Send the player ID and zone ID as separate strings.
| Field | Value |
|---|---|
game | mcgg |
player_idPlayer ID | A positive numeric string, up to 32 digits. |
zone_id | A separate positive numeric string, up to 16 digits. |
Keep the player ID and zone ID in separate fields.
Example JSON request
Send this body to POST /check through the RapidAPI gateway. This ID is illustrative; replace it with the account you intend to check.
{
"game": "mcgg",
"player_id": "123456789",
"zone_id": "1234"
}Use your RapidAPI application key and host. See the API documentation for complete authentication and error examples.
Read the lookup result
A completed lookup returns HTTP 200. When data.valid is true, display data.nickname. An explicitly invalid account returns valid: false and nickname: null.
data.region_code is an uppercase two-letter account country code when reported by the provider, or null when unavailable or invalid. Region availability varies by game and account; it is not inferred from the zone ID.
Temporary service errors return 5xx; do not treat them as an invalid player. Disabled integrations return HTTP 503. Respect Retry-After when present.
A nickname lookup does not prove account ownership. Game passwords are never required.
Use one API integration
Discover available games with GET /games?enabled=true, then submit the selected game ID to POST /check.