Integrace portálu Cloudová správa skupin se softwarem třetích stran

Integrační rozhraní API poskytuje koncové body, které usnadňují integraci se softwarem třetích stran. K integraci portálu Cloudová správa skupin Lexmark do vašeho systému použijte následující metody a klíče:

Načtení hodnot počitadel tiskárny

Toto volání zajistí načtení hodnot počitadel, jako jsou měřiče, pro prostředky v organizaci a podřízených organizacích. Organizace je určena z tokenu uvedeného v záhlaví Autorizace, který musí být načten z volání Načtení tokenu.

Poznámka: Tento koncový bod je nyní zastaralý se zavedením koncových bodů API verze 1.0.

Metoda

URL

GET

<ADRESA_URL_INTEGRAČNÍ_SLUŽBY>/assets/inventory/counters


Záhlaví

Klíč

Hodnota

Popis

Autorizace

Bearer <TOKEN>

Volání Načtení tokenu vrací token.


Tělo

Nic.

Schéma vracených dat

{
    "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
}

Ukázková odpověď

[
  {
    "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": {
    }
  }
]

Načtení tokenu

Tímto voláním se vygeneruje token vhodný pro použití s voláním Načtení hodnot počitadel tiskárny.

Metoda

URL

POST

<ADRESA_URL_IDP>oauth/token


Poznámka: <IDP_URL> je buď https://idp.eu.iss.lexmark.com pro organizaci v evropském datovém centru nebo https://idp.us.iss.lexmark.com/ pro organizaci v americkém datovém centru.
Záhlaví

Klíč

Hodnota

Content-Type

application/json


Tělo

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

Schéma vracených dat

{
    "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"]
}

Ukázková odpověď

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