Integrera Cloud Fleet Management med tredjepartsprogramvara

Integrerings-API:n tillhandahåller slutpunkter för att underlätta integrering med tredjepartsprogramvara. Använd följande metoder och nycklar för att integrera Lexmark Cloud Fleet Management i ditt system:

Hämta tillgångsräknare

Med det här anropet hämtas räknare, t.ex. mätare, för tillgångarna inom en organisation och dess underorganisationer. Organisationen bestäms av den token som anges under rubriken Behörighet, som måste hämtas från anropet Hämta token.

Obs! Den här slutpunkten är nu inaktuell i och med införandet av API-slutpunkter av version 1.0.

Metod

URL

GET

<INTEGRATION_SERVICE_URL>/assets/inventory/counters


Rubriker

Nyckel

Värde

Beskrivning

Behörighet

Ägare <TOKEN>

Med anropet Hämta token returneras token.


Meddelandetext

Inga.

Returschema

{
    "type": "array",
    "items": {
        "type": "object",
        "required": [ "serialNumber", "dateCollected", "counters" ],
        "properties": {
            "serialNumber": { "type": "string" },
            "dateCollected": { "type": "integer" },
            "counters": { 
                "type": "object",
                "properties": {
                    "lifetimeCount": { "type": "integer" },
                    "colorPrintSideCount": { "type": "integer" },
                    "colorPrintSheetCount": { "type": "integer" },
                    "monoPrintSideCount": { "type": "integer" },
                    "monoPrintSheetCount": { "type": "integer" },
                    "printSideCount": { "type": "integer" },
                    "printSheetCount": { "type": "integer" },
                    "colorCopySideCount": { "type": "integer" },
                    "colorCopySheetCount": { "type": "integer" },
                    "monoCopySideCount": { "type": "integer" },
                    "monoCopySheetCount": { "type": "integer" },
                    "copySideCount": { "type": "integer" },
                    "copySheetCount": { "type": "integer" },
                    "colorFaxSideCount": { "type": "integer" },
                    "colorFaxSheetCount": { "type": "integer" },
                    "monoFaxSideCount": { "type": "integer" },
                    "monoFaxSheetCount": { "type": "integer" },
                    "faxSideCount": { "type": "integer" },
                    "faxSheetCount": { "type": "integer" },
                    "colorSideCount": { "type": "integer" },
                    "colorSheetCount": { "type": "integer" },
                    "monoSideCount": { "type": "integer" },
                    "monoSheetCount": { "type": "integer" },
                    "totalSideCount": { "type": "integer" },
                    "totalSheetCount": { "type": "integer" },
                    "largeSideCount": { "type": "integer" },
                    "largeSheetCount": { "type": "integer" },
                    "duplexSideCount": { "type": "integer" },
                    "duplexSheetCount": { "type": "integer" },
                    "coverageTierBusinessSideCount": { "type": "integer" },
                    "coverageTierBusinessSheetCount": { "type": "integer" },
                    "coverageTierGraphicsSideCount": { "type": "integer" },
                    "coverageTierGraphicsSheetCount": { "type": "integer" },
                    "coverageTierHighlightSideCount": { "type": "integer" },
                    "coverageTierHighlightSheetCount": { "type": "integer" },
                },
            },
        },
    },
    "minItems": 0
}

Exempel på svar

[
  {
    "serialNumber": "14",
    "dateCollected": 1557259523000,
    "counters": {
      "monoPrintSideCount": 262,
      "printSideCount": 262,
      "printSheetCount": 262,
      "monoCopySideCount": 40,
      "copySideCount": 40,
      "copySheetCount": 40,
      "monoFaxSideCount": 0,
      "faxSideCount": 0,
      "faxSheetCount": 0,
      "monoSideCount": 302,
      "totalSideCount": 302,
      "totalSheetCount": 302,
      "duplexSheetCount": 0
    }
  },
  {
    "serialNumber": "29",
    "dateCollected": 1557259523000,
    "counters": {
      "lifetimeCount": 139,
      "monoPrintSideCount": 139,
      "printSideCount": 139,
      "printSheetCount": 136,
      "copySideCount": 0,
      "monoSideCount": 139,
      "totalSideCount": 139,
      "totalSheetCount": 136,
      "duplexSheetCount": 3
    }
  },
  {
    "serialNumber": "36",
    "dateCollected": null,
    "counters": {
    }
  }
]

Hämta token

Det här anropet genererar en token som är lämplig att använda med anropet Hämta tillgångsräknare.

Metod

URL

POST

<IDP_URL>oauth/token


Obs! <IDP_URL> är antingen https://idp.eu.iss.lexmark.com för en organisation i EU-datacentret eller https://idp.us.iss.lexmark.com/ för en organisation i USA- datacentret.
Rubriker

Nyckel

Värde

Content-Type

application/json


Meddelandetext

{
    "grant_type": "client_credentials",
		 "client_id": "<CLIENT_ID>",
		 "client_secret": "<CLIENT_SECRET>"
}

Returschema

{
    "properties" : {
        "access_token": {"type": "string"},
        "token_type": {"type": "string"},
        "expires_in": {"type": "integer"},
        "created_at": {"type": "integer"}
    },
    "required": ["access_token", "token_type", "expires_in", "created_at"]
}

Exempel på svar

{
    "access_token": "abcd1234",
    "token_type": "bearer",
    "expires_in": 7200,
    "created_at": 1572633120
}