Getting Started (Required)

This page provides a detailed overview of the platform integration, including common parameters, signature algorithms, multilingual configuration, and general error codes.

Merchant Notice

• OMG Server Time Zone：UTC+0，Integrators should be mindful of time zone calculations for data statistics.

• For OMG-provided APIs code=0 means success,For APIs implemented by the integratorcode=1means success

• The token returned by the OMG platform is valid for seven days. After seven days, it must be re-obtained.

• After the account opening requirements are approved, we will provide the merchant with a backend account. The merchant can view the app_id (merchant ID) and key (signature key) through the backend.

• In the documentation, replace {OMG_API_URL} with the test/production environment API endpoint provided in the merchant backend interface.

• In the documentation, replace {AGENT_URL} with the callback domain address configured by the integrator in the merchant backend.

• In the documentation, replace {OMG_BACKEND_URL} with the backend API domain obtained from the API configuration interface in the merchant backend.

---

Common Parameters

All API calls made by the OMG platform to the integrator will include common parameters

Name	Location	Reqiured	Type	Description
sign	header	Yes	string	Signature Algorithm and Example.
trace_id	url params	Yes	string	unique and randomly generated.

---

Signature Algorithm and Example

sign = md5(parameters_in_url + json_string_in_body + signature_key)

Note that the JSON string in the body must be the original content from the request body, not the string generated by a JSON package. The final output should be in lowercase.

Name	Value
Url	{OMG_API_URL}/api/luck/Balance/GetBalance?trace_id=dhf1aboc1iio
Type	POST
Content-Type	"application/json; charset=utf-8"
Body	{"player_logon_token":"b27cfe9b-f01c-11ee-a0b5-000c2901d9cc","account_id":"1002402","timestamp":1711971655}
Sign Key	39a6581c31ef3203a22edb2daa2ab6d1
Needs to be MD5 encrypted	trace_id=dhf1aboc1iio{"player_logon_token":"b27cfe9b-f01c-11ee-a0b5-000c2901d9cc","account_id":"1002402","timestamp":1711971655}39a6581c31ef3203a22edb2daa2ab6d1
Encrypted MD5 string.	e3f8dc79e875e46f6755ef540c2d24f3

CallBack

When the HTTP status code returned by the platform is 200, it indicates that the API request was successful, and the response can be parsed as expected. Any other HTTP error code indicates a network error. The returned Content-Type is "application/json; charset=utf-8".

{
    "code": 1,
    "msg": "success",
    "data": {
        "glist": [
            {
                "gameid": "9",
                "name": "mine",
                "platform": "1"
            }
        ]
    }
}

Name	Type	Description
code	integer	The code represents the status code. A value of 1 indicates success, and the data returned by the API will be placed in the data parameter.
msg	string	Error message
data	object	Response Data