Software-Funktionslizenzen und Nutzungslimits
Eine Ausfuhrberechtigung unterscheidet sich von 500 Ausfuhren pro Monat. RunFeature prüft die Berechtigung; RunMeteredFeature bestätigt Nutzung nach Geschäftserfolg.
Erlauben Sie 500 Exporte pro Monat
Fügen Sie den Export zu den Features der Richtlinie hinzu, dann ein Kontingent: Feature-Export, Limit 500, Zeitraum Monatlich. Standardmäßig wird die weitere Nutzung bei Erschöpfung abgelehnt. Um eine Überschreitung zuzulassen, legen Sie den Maximalwert fest. Das System erfasst die Mehrnutzung für Ihr Bestellsystem.
Tägliche und monatliche Kontingente werden um Mitternacht zurückgesetzt UTC; Lebenslange Kontingente werden nicht zurückgesetzt. Durch die Änderung eines Limits wird die verbrauchte Nutzung nicht gelöscht.
Bestätigen Sie die Verwendung nach einem erfolgreichen Export
Leiten Sie Ihren geschäftlichen Callback an das SDK weiter. Neue Jobs erfordern neue IDs; Bei Wiederholungsversuchen bleiben ID, Merkmal und Menge erhalten. Verschiedene Prozesse dürfen nicht gleichzeitig denselben Job ausführen.
| Sprache | Gemessener Geschäftsanruf |
|---|---|
| Go | client.RunMeteredFeature(ctx, "export", 1, jobID, exportReport) |
| Java | client.runMeteredFeature("export", 1, jobID, this::exportReport) |
| Node.js | await client.runMeteredFeature("export", 1, jobID, exportReport) |
| Python | client.run_metered_feature("export", 1, job_id, export_report) |
| C# | await client.RunMeteredFeature("export", 1, jobID, ExportReport) |
| C++ | client.RunMeteredFeature("export", 1, jobID, exportReport) |
| Rust | client.run_metered_feature("export", 1, &job_id, || export_report())? |
| Ruby | client.run_metered_feature("export", 1, job_id) { export_report } |
| C | ln_run_metered_feature(client, "export", 1, job_id, export_report, context) |
Configure a meter for the actual feature in your policy, then generate the AI integration prompt. AI should use the language's RunMeteredFeature with a stable business operation ID, preserving that ID when retrying the same task.
Wenn das Geschäft erfolgreich ist, die Bestätigung jedoch fehlschlägt, wird durch einen erneuten Versuch desselben Jobs lediglich bestätigt; es wiederholt sich nie. Ein Absturz während des Geschäftsbetriebs blockiert die automatische Wiedergabe. Überprüfen Sie Ihr dauerhaftes Ergebnis, dann bestätigt oder bricht ResolveMeteredFeature ab. Remote-Nutzung und lokales Geschäft sind keine Transaktion.
Wenn Sie Reservierungen selbst kontrollieren müssen
- Erstellen und speichern Sie eine Job-ID für diesen Export.
- Reservieren Sie eine Einheit und exportieren Sie sie erst, nachdem sie aussteht. „committed“ bedeutet, dass die Arbeit bereits abgeschlossen ist; nicht erneut ausführen.
- Nach erfolgreichem Export und Speichern des Ergebnisses rufen Sie Commit auf, um die Verwendung zu bestätigen.
- Wenn der Export vor Abschluss fehlschlägt, rufen Sie „Abbrechen“ auf, um die Sperre aufzuheben, ohne Einheiten zu verbrauchen.
Hält standardmäßig die letzten 15 Minuten und wird bei einem Zurücksetzen auf UTC verkürzt. Direkte API Anrufer können reservation_seconds auf 30–3600 Sekunden einstellen.
| Sprache | Reservieren | Festschreiben / Abbrechen |
|---|---|---|
| Go | Reserve(ctx, "export", 1, jobID) | Commit / Cancel(ctx, hold.ID, jobID) |
| Java / Node.js | reserve("export", 1, jobID) | commit / cancel(id, jobID) |
| C | ln_reserve(client, "export", 1, jobID) | ln_commit / ln_cancel(client, id, jobID) |
| C++ / C# | Reserve("export", 1, jobID) | Commit / Cancel(id, jobID) |
| Python | reserve("export", 1, jobID) | commit / cancel(id, jobID) |
So lesen Sie die Antwortfelder
| Feld | Bedeutung |
|---|---|
| reservation_id / operation_id | Reservierungs-ID und ursprüngliche Job-ID; Behalten Sie die gleichen Werte für Wiederholungsversuche bei. |
| status / expires_at | Haltestatus und Frist: „Ausstehend“ wartet auf den Abschluss, „Zugesagt“ wird belastet, „Storniert“ wird freigegeben, „Abgelaufen“ ist abgelaufen. |
| consumption.used / reserved | Bestätigt verwendet diesen Zeitraum/diese Einheiten, die von allen aktiven Reservierungen belegt sind. |
| consumption.limit / remaining | Grundfreibetrag / verfügbare Grundeinheiten. verbleibend = max(0, limit - used - reserved), ohne zulässige Überschreitung. |
| consumption.quantity / overage | Einheiten für diese Stelle / bestätigte Einheiten über der Grundvergütung; Es wird keine Kundenzahlung eingezogen. |
| consumption.period / reset_at | UTC Nutzungszeitraum / nächster Reset; lebenslange Zulagen haben reset_at = null. |
Informationen zu Anforderungstexten, Antworten und Feldtypen finden Sie unter „Reservieren“, „Commit“ und „Abbrechen“ in der Laufzeitreferenz API.
Nach Erfolg nicht abbrechen oder erneut exportieren. Behalten Sie die IDs und das Ergebnis bei und wiederholen Sie den Commit-Vorgang. Wenn die Sperre abgelaufen ist, behalten Sie den Job zur Abstimmung. Remote-Nutzung und lokale Geschäftsarbeit können keine atomare Transaktion gemeinsam nutzen.
Consume zeichnet die Nutzung weiterhin sofort auf. Nutzen Sie Reservierungen, um zu vermeiden, dass fehlgeschlagene Arbeiten in Rechnung gestellt werden. Alle funktionalen Nutzungsendpunkte erfordern eine Verbindung und sind von den vier kostenpflichtigen API-Vorgängen der Plattform ausgeschlossen.