Player Details

POST /Account/Read/Player

Returns details about the most recently used players. Secret Hmac Required. Cache Time 15 Minutes.

Body

  • If set, selects players active in this many days. Defaults to 0 which is the last 15 minutes.

  • If set, selects players not active for more than this many days. Defaults to 0 which selects active players.

Responses

  • Player Information successfully returned

    Hide response attributes Show response attributes object
    • ServerId number

      Server id number

    • UniqueId string

      the server uid sent by the remote server

    • PlayerId number

      the playback id that this is monitoring

    • DatePing string

      the date that the 5 minute ping occurred (linux only)

    • the date that this was updated

    • Parent number

      Parent User Number (top level)

    • Custno number

      customer number

    • Active number

      active or not - 1 = linux, 2 = windows old startsign, 3 = windows new startsign

    • the date that this was installed

    • Username string

      the username used to initialize the player

    • PcName string

      the pc name

    • Mac string

      the mac address of the primary network card (visual form)

    • IP Address as seen from the outside world

    • IP Address that the server is set to (inside firewall)

    • Name string

      a pc name

    • the starting date/time for the use count and bandwidth

    • UseCount number

      the number of times this server has communicated since DateStart

    • the bandwidth that has been used by this server since DateStart

    • DailyUse number

      average times this server per day

    • DailyBW number

      average daily bandwidth

    • the number of errors since usestart

    • ErrorMsg string

      last error message received

    • the date that the last error message was sent

    • the date that the error was recovered

    • DateInfo string

      the date that the last remoteinfo was requested

    • DateFile number

      the date that the last error message was sent

    • DateDb string

      the date that the database restore happened

    • the date that the last full database was completed

    • the date that the last player restart was initiated

    • the date that the last reboot was initiated

    • the date that the last email was sent

    • DatePlay number

      when a signage component reports this server uid

    • the count of emails sent

    • the count of files requested the last time

    • the count of database records on the pc

    • the pc details

    • OS string

      the operating system

    • SerialNo string

      the model/serial number (initially, the last 12 is the root password)

    • RootPW string

      the root password with LibEncrypPass format

    • the server load on the last database import call (each minute)

    • the time difference for the server (in seconds)

    • Extra object

      extra information

POST /Account/Read/Player
curl \
 -X POST https://Api.StrandVision.com/v1.0/Account/Read/Player \
 -H "Authorization: X-apikey $ACCESS_TOKEN" \
 -H "Authorization: X-apidate $ACCESS_TOKEN" \
 -H "Authorization: X-apihmac $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"SelectActive":1,"SelectInActive":0}'
Request example
{
  "SelectActive": 1,
  "SelectInActive": 0
}
Request examples
{
  "SelectActive": 1,
  "SelectInActive": 0
}
Response examples (200)
[
  {
    "ServerId": 242,
    "UniqueId": "rhald9-l48j9r-27jtm1e5rj",
    "PlayerId": "",
    "DatePing": 0,
    "DateUpdate": "Thu, 20 Jul 2023 21:45:00 GMT",
    "Parent": 10028,
    "Custno": 10028,
    "Active": 1,
    "DateInstalled": "Sat, 27 Aug 2022 21:07:57 GMT",
    "Username": "strandbuild",
    "PcName": "MikeOffice",
    "Mac": "00:50:56:9B:42:97",
    "Remote_Addr": "38.103.247.52",
    "Local_Addr": "192.168.200.18",
    "Name": "Mike's Desktop in his office",
    "DateStart": "Thu, 20 Jul 2023 18:38:00 GMT",
    "UseCount": 83,
    "Bandwidth": "45.8KB",
    "DailyUse": 0,
    "DailyBW": 0,
    "ErrorCount": 1,
    "ErrorMsg": "Bug Error: (IP 192.168.200.18) Process OptimizeTable 2, error 9999 - 127.0.0.1:onlinek_kiosks:SLOW table library with 5267 records took 6.59209 of 2 seconds (799 per second)",
    "DateError": "Thu, 20 Jul 2023 21:40:53 GMT",
    "DateRecover": 0,
    "DateInfo": "Thu, 20 Jul 2023 21:38:00 GMT",
    "DateFile": 0,
    "DateDb": "Thu, 20 Jul 2023 21:40:35 GMT",
    "DateFullDb": 0,
    "DateRestart": "Fri, 31 Mar 2023 14:23:14 GMT",
    "DateReboot": "Wed, 24 May 2023 12:48:52 GMT",
    "DateEmail": "Thu, 20 Jul 2023 21:40:53 GMT",
    "DatePlay": 0,
    "CountEmail": 1,
    "CountFile": 0,
    "CountRecord": 11508,
    "DetailsPC": "8@3Ghz Intel Xeon E5-2690, 32GB Ram",
    "OS": "Ubuntu 22.04 x64 generic",
    "SerialNo": "DEV_SERVER",
    "RootPW": "XKU36SROT1JMI40FM9FCXDOH1KQD",
    "ServerLoad": 8,
    "SecondsDiff": 0,
    "Extra": [
      {
        "disk": "8% (4TB free)",
        "maclst": "ens160.27jtm1e5rj",
        "kernel": "5.15.0-76-generic",
        "tx": "296.8GB",
        "rx": "894.6GB",
        "txd": 0,
        "rxd": 0
      }
    ]
  }
]
Response examples (200)
{
  "ServerId": 242,
  "UniqueId": "rhald9-l48j9r-27jtm1e5rj",
  "PlayerId": 42.0,
  "DatePing": 0,
  "DateUpdate": "Mon, 31 Jul 2023 15:05:00 GMT",
  "Parent": 10028,
  "Custno": 10028,
  "Active": 1,
  "DateInstalled": "Sat, 27 Aug 2022 21:07:57 GMT",
  "Username": "string",
  "PcName": "string",
  "Mac": "00:50:56:9B:42:97",
  "Remote_Addr": "38.103.247.52",
  "Local_Addr": "192.168.200.18",
  "Name": "Mike's Desktop in his office",
  "DateStart": "Mon, 31 Jul 2023 15:05:00 GMT",
  "UseCount": 0,
  "Bandwidth": "1.2KB",
  "DailyUse": 0,
  "DailyBW": 0,
  "ErrorCount": 1,
  "ErrorMsg": "string",
  "DateError": "Thu, 27 Jul 2023 22:19:39 GMT",
  "DateRecover": 0,
  "DateInfo": "Mon, 31 Jul 2023 15:05:07 GMT",
  "DateFile": 0,
  "DateDb": "Mon, 31 Jul 2023 15:05:34 GMT",
  "DateFullDb": 0,
  "DateRestart": "Fri, 31 Mar 2023 14:23:14 GMT",
  "DateReboot": "Wed, 24 May 2023 12:48:52 GMT",
  "DateEmail": "Thu, 27 Jul 2023 22:19:39 GMT",
  "DatePlay": 0,
  "CountEmail": 1,
  "CountFile": 0,
  "CountRecord": 11504,
  "DetailsPC": "8@3Ghz Intel Xeon E5-2690, 32GB Ram",
  "OS": "Ubuntu 22.04 x64 generic",
  "SerialNo": "DEV_SERVER",
  "RootPW": "XKU3BRS9F8MD0ZCHH83D79SH1KQD",
  "ServerLoad": 10,
  "SecondsDiff": 6,
  "Extra": {}
}