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:
| Header | Description | Required |
|---|---|---|
X-API-KEY | Your API key | ✅ |
X-API-REQUEST | Unique UUID v7 | ✅ |
X-API-SIGNATURE | HMAC signature | ✅ |
Content-Type | application/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 Type | Headers Required | Notes |
|---|---|---|
200 OK Success | ✅ X-API-SIGNATURE | Generate signature using response body |
| Error Responses | ❌ No signature | 4xx and 5xx responses don't need signatures |