Ενσωμάτωση του Cloud Fleet Management σε λογισμικό τρίτων κατασκευαστών

Το API ενσωμάτωσης παρέχει καταληκτικά σημεία που διευκολύνουν την ενσωμάτωση σε λογισμικό τρίτων κατασκευαστών. Χρησιμοποιήστε τις μεθόδους και τα κλειδιά που περιγράφονται παρακάτω για να ενσωματώσετε το Cloud Fleet Management της Lexmark στο σύστημά σας:

Retrieve Asset Counters (Ανάκτηση μετρητών των πόρων της επιχείρησης)

Με αυτήν την κλήση ανακτώνται μετρητές, όπως οι μετρητές των πόρων μιας επιχείρησης και των θυγατρικών της επιχειρήσεων. Η επιχείρηση προσδιορίζεται από το διακριτικό στην κεφαλίδα εξουσιοδότησης, το οποίο πρέπει να ανακτηθεί από την κλήση Ανάκτησης διακριτικού.

Σημ.: Αυτό το τελικό σημείο υποβαθμίζεται τώρα με την εισαγωγή των τελικών σημείων της έκδοσης API 1.0.

Μέθοδος

Διεύθυνση URL

GET

<INTEGRATION_SERVICE_URL>/assets/inventory/counters


Κεφαλίδες

Κλειδί

Τιμή

Περιγραφή

Εξουσιοδότηση

Bearer <TOKEN> (Φορέας <ΔΙΑΚΡΙΤΙΚΟ>)

Η κλήση Retrieve Token (Ανάκτηση διακριτικού) επιστρέφει το διακριτικό.


Κυρίως κείμενο

Καμία.

Σχήμα επιστροφής

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

Παράδειγμα ανταπόκρισης

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

Retrieve Token (Ανάκτηση διακριτικού)

Αυτή η κλήση δημιουργεί ένα διακριτικό που είναι κατάλληλο για χρήση με την κλήση Ανάκτησης μετρητών των πόρων.

Μέθοδος

Διεύθυνση URL

POST

<IDP_URL>oauth/token


Σημ.: Το <IDP_URL> είναι είτε https://idp.eu.iss.lexmark.com για μια εταιρεία στο κέντρο δεδομένων της ΕΕ, είτε https://idp.us.iss.lexmark.com/ για μια εταιρεία στο κέντρο δεδομένων στις Η.Π.Α.
Κεφαλίδες

Κλειδί

Τιμή

Τύπος περιεχομένου

application/json


Κυρίως κείμενο

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

Σχήμα επιστροφής

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

Παράδειγμα ανταπόκρισης

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