Die Integrations-API stellt Endpunkte bereit, um die Integration in Software von Drittanbietern zu erleichtern. Verwenden Sie die folgenden Methoden und Schlüssel, um Lexmark Flottenmanagement in Ihr System zu integrieren:
Asset-Zähler abrufen
Mit diesem Aufruf werden Zähler abgerufen, zum Beispiel solche für die Assets einer Organisation und ihrer untergeordneten Organisationen. Die Organisation wird anhand des in der Autorisierungskopfzeile angegebenen Tokens bestimmt, das aus der Abfrage Token abrufen abgerufen werden muss.
Hinweis: Dieser Endpunkt ist mit der Einführung der Endpunkte in API-Version 1.0 veraltet.
Methode | URL |
---|
GET | INTEGRATION_SERVICE_URL>/assets/inventory/counters |
KopfzeileSchlüssel | Wert | Beschreibung |
---|
Autorisierung | Träger <TOKEN> | Die Abruf-Token-Abfrage gibt das Token zurück. |
Rückgabeschema
{
"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
}
Beispielantwort
[
{
"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": {
}
}
]
Abruf-Token
Diese Abfrage generiert ein Token, das für die Verwendung mit der Abfrage Asset-Zähler abrufen geeignet ist.
Methode | URL |
---|
POST | <IDP_URL> oauth/token |
Hinweis: <IDP_URL> ist entweder https://idp.eu.iss.lexmark.com für eine Organisation im EU-Rechenzentrum oder https://idp.us.iss.lexmark.com/ für eine Organisation im US-Rechenzentrum.
KopfzeileSchlüssel | Wert |
---|
Inhaltstyp | application/json |
Text
{
"grant_type": "client_credentials",
"client_id": "<CLIENT_ID>",
"client_secret": "<CLIENT_SECRET>"
}
Rückgabeschema
{
"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"]
}
Beispielantwort
{
"access_token": "abcd1234",
"token_type": "bearer",
"expires_in": 7200,
"created_at": 1572633120
}