API-Nutzung
ITscope rechnet die API je Kalendermonat gegen ein Kontingent ab — etwa API Lite mit 5.000 und API Plus mit 20.000 Aufrufen im Monat. Die Liste ITscope-API-Nutzung zählt jeden Aufruf des Connectors je Monat und Kategorie, damit Sie den Verbrauch sehen, bevor ITscope ihn meldet.
Seite öffnen
- Dashboard → API-Nutzung (nur mit eingeschalteten API-Funktionen)
- ITscope-Einstellungen → Klick auf API-Aufrufe diesen Monat
- Suche: ITscope-API-Nutzung
Felder
| Feld | Bedeutung |
|---|---|
| Periodenbeginn | Der erste Tag des Monats, den die Zeile zählt |
| Kategorie | Wofür die Aufrufe waren — siehe unten |
| Anzahl Aufrufe | Wie viele Aufrufe dieser Kategorie im Monat bei ITscope angekommen sind |
| Letzter Aufruf am | Wann zuletzt ein Aufruf dieser Kategorie erfolgte |
Kategorien
| Kategorie | Aufrufe |
|---|---|
| Warenkorb | Warenkörbe vorbereiten |
| Bestellung | Verbindliche Bestellungen senden |
| Dokumente | Auftragsbestätigungen, Lieferavise und Rechnungen abrufen, dazu jedes Rechnungs-PDF |
| Deal-Status | Statusabfragen — im Belegrücklauf, mit Deal-Status aktualisieren und bei der Suche nach bestellten Warenkörben |
| Produktdaten | Verfügbarkeitsprüfungen auf der Einkaufsbestellung — ein Aufruf je bis zu 50 Produkte |
Was gezählt wird
- Jeder Aufruf, der ITscope erreicht hat — auch einer, den ITscope mit einem Fehler beantwortet. Ein Aufruf, der ITscope nie erreicht hat, zählt dort nicht und hier auch nicht.
- Nicht der Katalogimport. Der Export-Download läuft über den Teilen-Link, außerhalb jedes API-Kontingents.
- Gezählt wird je Mandant und Kalendermonat. Teilen sich mehrere Mandanten ein ITscope-Konto, zählt jeder nur seine eigenen Aufrufe — das Kontingent gilt dann für die Summe.
Das Kontingent
Tragen Sie in den ITscope-Einstellungen das API-Monatskontingent Ihres Pakets ein. Das Dashboard stellt die Aufrufe dieses Monats dann dem Kontingent gegenüber — in der Karte Verbindung und Sync, ab 80 % in Achtungsfarbe, ab 100 % kritisch. Mit 0 (unbegrenzt oder unbekannt) zeigt es nur die Zahl; gezählt wird trotzdem.
Der größte Posten ist der Belegrücklauf
Der Belegrücklauf fragt in jedem Lauf jede offene Bestellung ab. Im Zeitfenster der Aufgabe (Montag bis Freitag, 06:00 bis 20:00) kostet ein 15-Minuten-Takt rund 1.200 Aufrufe im Monat je offener Bestellung, der Standard von 60 Minuten rund 300. Das Belegrücklauf-Intervall ist deshalb der wirksamste Hebel; die Suche nach Bestellungen, die nicht über den Connector gesendet wurden, kostet dagegen nur etwa einen Aufruf je Lauf.
Wenn das Kontingent erschöpft ist
ITscope lehnt weitere Aufrufe dann ab — der Connector meldet es als HTTP 403 mit dem Hinweis, dass das gebuchte Paket die Funktion nicht umfasst oder das Kontingent aufgebraucht ist. Kommen zu viele Anfragen in einer Minute, antwortet ITscope mit HTTP 503; dann genügt es, eine Minute zu warten.