Integracyjny interfejs API zapewnia punkty końcowe ułatwiające integrację z oprogramowaniem innych firm. Aby zintegrować usługę Cloud Fleet Management firmy Lexmark z systemem, użyj następujących metod i kluczy:
Pobierz liczniki zasobów
To wywołanie pobiera liczniki, takie jak mierniki, z zasobów w organizacji i jej organizacjach podrzędnych. Organizacja jest określana na podstawie tokenu określonego w nagłówku Authorization, który musi zostać pobrany z wywołania Pobierz token.
Uwaga: Ten punkt końcowy jest obecnie przestarzały wraz z wprowadzeniem punktów końcowych API w wersji 1.0.
| Sposób | URL |
|---|
GET | <INTEGRATION_SERVICE_URL>/assets/inventory/counters |
Nagłówki| Klucz | Wartość | Opis |
|---|
Autoryzacja | Nośnik <TOKEN> | Wywołanie Pobierz token zwraca token. |
Schemat powrotny
{
"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
}Przykładowa odpowiedź
[
{
"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": {
}
}
]Pobierz
To wywołanie generuje token, który można wykorzystać z wywołaniem Pobierz liczniki zasobów.
| Sposób | URL |
|---|
POST | <IDP_URL>oauth/token |
Uwaga: Adres <IDP_URL> to https://idp.eu.iss.lexmark.com dla organizacji w centrum przetwarzania danych UE lub https://idp.us.iss.lexmark.com/ dla organizacji w centrum przetwarzania danych w USA.
Nagłówki| Klucz | Wartość |
|---|
Content-Type | application/json |
Treść
{
"grant_type": "client_credentials",
"client_id": "<CLIENT_ID>",
"client_secret": "<CLIENT_SECRET>"
}Schemat powrotny
{
"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"]
}
Przykładowa odpowiedź
{
"access_token": "abcd1234",
"token_type": "bearer",
"expires_in": 7200,
"created_at": 1572633120
}