Nutzung, Zuverlässigkeit und Datenverarbeitung
Verstehen Sie Records, Stufen, Fehler, Wiederholungen, Zugangsdaten, Aufbewahrung und Offline-Aktivierung.
Records, API-Stufen und Abrechnungszyklen
Ein Basis-Record umfasst bis zu 1.000 Unicode-Codepunkte pro Text, für jeden Text einzeln aufgerundet, mindestens eine Einheit. Die API-Stufe gewichtet diesen Basiswert. Bruchteile bleiben in Zehntel-Records erhalten.
| API-Stufe | Record-Faktor | Limit nativer Anfragen |
|---|---|---|
| Standard | 1,0 | 64 Texte · 200.000 Codepunkte pro Text |
| Batch | 0,5 | 200 Texte · 200.000 Codepunkte pro Text |
| Real-Time | 1,6 | 4 Texte · 4.000 Codepunkte pro Text |
Zwei Texte mit je 800 Zeichen verbrauchen beispielsweise 2 Standard-Records, 1 Batch-Record oder 3,2 Real-Time-Records. Natives Batch ist eine Verarbeitungsstufe mit niedrigerer Priorität; asynchrone Azure-Jobs haben einen separaten Anfragelebenszyklus.
Zuerst wird das Plankontingent genutzt, dann Pack-Records. Monatskontingent wird zur Abrechnungsgrenze zurückgesetzt und nicht übertragen. Packs laufen nicht ab. Ein Upgrade erfordert Zahlung und startet einen neuen Zyklus mit vollem neuem Kontingent; Downgrade oder Kündigung gelten zum Periodenende. Prüfen Sie die Betragsvorschau im Dashboard vor der Bestätigung.
Verbrauch sehen Sie im Dashboard oder GET /v1/usage. Das Abrechnungsportal bietet Rechnungs-PDFs, Unternehmensdaten und Zahlungsmittel. Anwendbare Steuern werden beim Checkout berechnet und Rechnungen nach dem Kauf per E-Mail versandt.
Fehler und Wiederholungen
Native API-Fehler verwenden {"error":{"code":"…","message":"…"}}. Azure-kompatible Endpunkte verwenden eigene Fehlerstrukturen. Bewahren Sie X-Request-Id für die Fehlersuche auf.
| Status | Aktion |
|---|---|
| 401 | Schlüssel, Widerrufsstatus und Umgebung prüfen. |
| 402 | Records hinzufügen; der Fehler nennt benötigte und verfügbare Menge. |
| 403 | Prüfen, ob der Plan die angeforderte Stufe enthält. |
| 413 / 422 | Eingabe korrigieren oder Anfrage innerhalb der dokumentierten Grenzen aufteilen. |
| 429 | Beachten Sie Retry-After, dann mit wachsendem Abstand und zufälliger Verzögerung wiederholen. |
| 503 | Vorübergehender Dienstausfall. Beachten Sie Retry-After falls vorhanden. |
Validierungsfehler und vor der Verarbeitung abgelehnte Anfragen verbrauchen keine Records. Ein Verbindungsabbruch beweist kein Verarbeitungsversagen: Bewahren Sie die Anfragereferenz auf und prüfen Sie den Verbrauch, bevor Sie große Aufträge blind wiederholen. Synchrone Ergebnisse werden nicht zur Wiederholung gespeichert.
Datenverarbeitung und Schlüssel
Synchrone Texte und Ersatzwertzuordnungen werden im Speicher verarbeitet. Betriebsbezogene Verbrauchsdaten enthalten Kennungen, Mengen und Zeiten statt Dokumentinhalten. Asynchrone Jobeingaben und Ergebnisse benötigen verschlüsselte temporäre Speicherung und laufen nach 24 Stunden ab. Ihre Anwendung bestimmt die Aufbewahrung zurückgegebener Ergebnisse und Zuordnungen.
API-Schlüssel erstellen und widerrufen Sie im Dashboard. Starter erlaubt einen Schlüssel, höhere Pläne bis zu fünf. Produktionsschlüssel beginnen mit shr_live_, Sandbox-Schlüssel mit shr_test_. Sie gehören zu getrennten Umgebungen. Betten Sie sie nicht in Browser-Anwendungen, URLs oder Supportnachrichten ein.
Offline-Aktivierung
