List All Machines with Active License Checkouts

The matchmaking API will return a list of all Cargo Spectre devices that have successfully checked out a license using your credentials. You can manually view these records at https://spectre-licensing.com.

HTTPS required

The cloud server is separate from Spectre Dimensioner API calls and uses a different endpoint. Please note that for security, the endpoint MUST be HTTPS and not HTTP.

<Matchmaking/List>

Request

POST

Endpoint

POST https://spectre-licensing.com/matchmaking/list

Header

JSON

Desired response format:

Accept: application/json (DEFAULT)

XML

Desired response format:

Accept: application/xml

Body

JSON

{
    "email": "fake@company.com",
    "password": "FakePassword123!"
}

XML

Receiving XML from the cloud

To receive XML back, the request must specify the Accept header with the value set to application/xml otherwise the response will be returned in JSON.

<MatchmakingRequest>
    <Email>fake@company.com</Email>
    <Password>FakePassword123</Password>
</MatchmakingRequest>

GET

Unsupported

This request is unsupported for this API command.

Response

JSON

{
  "matches": [
    {
      "matchmakingID": 10,
      "publicIP": "100.150.162.60",
      "localIP": "192.168.1.100:321",
      "macAddress": "bbb156d2651f",
      "machineName": "Dock 5",
      "lastUpdated": "2016-12-18T13:57:14.777059",
      "location": null
    },
    {
      "matchmakingID": 403,
      "publicIP": "",
      "localIP": "127.0.0.1:7100",
      "macAddress": "f46d04698d",
      "machineName": "Receiving Bay",
      "lastUpdated": "2016-11-20T16:21:07.8148707",
      "location": "Houston, TX"
    },
    {
      "matchmakingID": 485,
      "publicIP": "48.78.4.91",
      "localIP": "192.168.1.197:7100",
      "macAddress": "742f681c2d",
      "machineName": "Departure Scanner",
      "lastUpdated": "2016-11-20T15:16:27.4377527",
      "location":"JFK"
    }
  ],
  "error": null
}

XML

<MatchmakingResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <Matches>
        <Match>
            <MatchmakingID>10</MatchmakingID>
            <PublicIP>100.150.162.60</PublicIP>
            <LocalIP>192.168.1.100:321</LocalIP>
            <MACAddress>bbb156d2651f</MACAddress>
            <MachineName>Dock 5</MachineName>
            <LastUpdated>2016-12-18T13:57:14.777059</LastUpdated>
            <Location>null</Location>
        </Match>
        <Match>
            <MatchmakingID>403</MatchmakingID>
            <PublicIP>8.211.81.5</PublicIP>
            <LocalIP>127.0.0.1:7100</LocalIP>
            <MACAddress>f46d04698d</MACAddress>
            <MachineName>Receiving Bay</MachineName>
            <LastUpdated>2016-11-20T16:21:07.8148707</LastUpdated>
            <Location>Houston, TX</Location>
        </Match>
        <Match>
            <MatchmakingID>485</MatchmakingID>
            <PublicIP>48.78.4.91</PublicIP>
            <LocalIP>192.168.1.197:7100</LocalIP>
            <MACAddress>742f681c2d</MACAddress>
            <MachineName>Departure Scanner</MachineName>
            <LastUpdated>2016-11-20T15:16:27.4377527</LastUpdated>
            <Location>JFK</Location>
        </Match>
    </Matches>
</MatchmakingResponse>