Knowledge Base

Description

This endpoint is used for getting player config data related to player setup

This endpoint must be consumed in GET request

Security

This endpoint is secured, you must send a Bearer Token, to be able to invoke the endpoint, for getting the token, you should invoke first the /oauth/token service of the security microservice, if you don't know what service is, please talk with your sysadmin for further information

Request

As part of the request a Bearer Token must be sended, (if you don't send a valid token a 401 error will be retrieved), look the next example in Postman to better understanding

Copy codecurl --location 'host:port/zynchro.api.player-config/v1/player-setup/player-config?client_id=38&transaction_id=123456' \
--header 'Authorization: Bearer *********'

In java it would be something like this (depending on the dependency you use)

Copy codeOkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("{{host}}:{{}port}/zynchro.api.player-config/v1/player-setup/player-config?client_id=38&transaction_id=123456")
  .method("GET", body)
  .addHeader("Authorization", "Bearer ••••••")
  .build();
Response response = client.newCall(request).execute();

Next are listed the params required in the request

Consuming Service

Example Request

Consuming service 

(GET) URL:HOST:PORT/zynchro.api.player-config/v1/player-setup/player-config?client_id=38&transaction_id=123456

Request Params:

• transaction_id=123456
  
• client_id=38
  

Response

Response 200 OK

If the params present in the request are valid, then you will receive a response 200 "ok" message code look at the next example:

Copy code{
    "header": {
        "resultCode": "ok",
        "messageCode": "ok",
        "messageDescription": "request ok",
        "transactionId": "123456"
    },
    "data": [
        {
            "id": 190,
            "clientId": 38,
            "name": "No VLANs",
            "timeServer": "http://time.brightsignnetwork.com",
            "useHostName": false,
            "hostName": null,
            "useProxy": true,
            "proxyIPHostname": "http://sysproxy.wal-mart.com",
            "proxyPort": 8080,
            "primaryNetwork": 1,
            "isWiredStatic": false,
            "wiredIPAddress": null,
            "wiredSubnetMask": null,
            "wiredGateway": null,
            "wiredDNS1": null,
            "wiredDNS2": null,
            "wiredDNS3": null,
            "wiredIsActiveVLan": false,
            "isWirelessActive": false,
            "isWirelessStatic": false,
            "wirelessSSID": null,
            "wirelessSecurityKey": null,
            "wirelessIPAddress": null,
            "wirelessSubnetMask": null,
            "wirelessGateway": null,
            "wirelessDNS1": null,
            "wirelessDNS2": null,
            "wirelessDNS3": null,
            "wirelessIsActiveVLan": false,
            "wasDeleted": false,
            "wasUsed": true,
            "createdDate": "2025-11-15T23:55:24.000+00:00",
            "defaultConfig": false
        },
        {
            "id": 12,
            "clientId": 38,
            "name": "Test-Full-Network",
            "timeServer": "http://time.brightsignnetwork.com",
            "useHostName": false,
            "hostName": "192.168.1.1",
            "useProxy": true,
            "proxyIPHostname": "http://192.168.1.6",
            "proxyPort": 32,
            "primaryNetwork": 1,
            "isWiredStatic": true,
            "wiredIPAddress": "192.168.1.88",
            "wiredSubnetMask": "255.255.255.0",
            "wiredGateway": "192.168.1.254",
            "wiredDNS1": "8.8.8.8",
            "wiredDNS2": "8.8.4.4",
            "wiredDNS3": "1.1.1.1",
            "wiredIsActiveVLan": true,
            "isWirelessActive": true,
            "isWirelessStatic": true,
            "wirelessSSID": "INFINITUM3922",
            "wirelessSecurityKey": "Ca9Lg5Ec2x",
            "wirelessIPAddress": "192.168.1.90",
            "wirelessSubnetMask": "255.255.255.0",
            "wirelessGateway": "192.168.1.254",
            "wirelessDNS1": "8.8.8.8",
            "wirelessDNS2": "8.8.4.4",
            "wirelessDNS3": "2.2.2.2",
            "wirelessIsActiveVLan": false,
            "wasDeleted": false,
            "wasUsed": true,
            "createdDate": "2023-10-25T16:56:04.000+00:00",
            "defaultConfig": false
        }
    ]
}

Description of the response data

Response 400

If there are errors with the request, then you will receive a 400 message response BAD_REQUEST with the errors field present, like the following example:

Copy code{
    "header": {
        "resultCode": "error",
        "messageCode": "BAD_REQUEST",
        "messageDescription": "Please check your params fields",
        "transactionId": "123456"
    },
    "errors": [
        {
            "fieldName": "client_id",
            "fieldDesc": "Field is required, and must be of type int "
        }
    ]
}

Response 401

If you dont send any token, then you will receive a error message of "unauthorized", look at the next example:

Copy code{
    "error": "unauthorized",
    "error_description": "Full authentication is required to access this resource"
}

Copy code{
    "error": "invalid_token",
    "error_description": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MDM2MTk5NzMsInVzZXJfbmFtZSI6ImFsZWphbmRyby56YW5hYnJpYUBkaWdpd29ya3MuY29tLm14IiwiYXV0aG9yaXRpZXMiOlsiUk9MRV9TWVNURU1BRE1JTiJdLCJqdGkiOiJHTGtQb3hQbVRTZUs2RFhmc1NfNkUxRkMxZmsiLCJjbGllbnRfaWQiOiJ6eW5jaHJvIiwic2NvcGUiOlsicmVhZCIsIndyaXRlIl19.yAFbdU18wMtQXSGUY3_noQn4BQv0RqYjDbw0sr1x6Yk"
}

This is the data retrieved when the 401 Unauthorized is retrieved:

Postman collection