API Reference
Overview

API Reference

🔗

Base URL: https://partner-api.example.com (Replace with your actual endpoint)

Required APIs

These APIs must be implemented by all game partners:

Optional APIs

Common Response Format

⚠️

Important: All APIs should return HTTP Status 200 OK as a successful response and use the success field to indicate the actual result.

Success Response

{
  "success": true,
  // ... additional required fields
}

Error Response

{
  "success": false,
  "errorCode": "ERR-XX",
  "errorMessage": "Description of what went wrong"
}

Authentication Headers

All API requests from YGG will include these headers:

HeaderDescriptionRequired
X-API-KEYYour API key
X-API-REQUESTUnique UUID v7
X-API-SIGNATUREHMAC signature
Content-Typeapplication/json
🔐

See Authentication for detailed HMAC signature implementation.

Response Requirements

🔑

Critical: For 200 OK responses, you MUST include X-API-SIGNATURE in response headers.

Response TypeHeaders RequiredNotes
200 OK SuccessX-API-SIGNATUREGenerate signature using response body
Error Responses❌ No signature4xx and 5xx responses don't need signatures