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. |
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
}