Öffentlichen Katalog vom privaten Empfang trennen
Öffentliche Daten beschreiben Dienst, Land, Preis und Dauer. Sie enthalten keine zugewiesene Telefonnummer oder Codes. Aktivierungen gehören zu einem Konto und einer Bestellung mit separater privater Nachverfolgung.
Das Dienst- und Länderverzeichnis ist getrennt von kommerziellen Angeboten. Der Integrationsvertrag erfordert einen API-Katalog mit autoritativen Preisen und Verfügbarkeiten für Bestellungen.
Katalog und Bestellung
Der bestehende Vertrag spezifiziert GET /catalog/products und GET /catalog/products/:slug. Das Backend liefert autoritative Preise, Dauer und explizite Verfügbarkeit; fehlender Bestand bleibt unbekannt.
Bestellungen senden einen Produktbezeichner mit einem Idempotenzschlüssel. Der Server prüft Preis und Lagerbestand vor Reservierung oder Zuweisung. Das Lesen einer Seite löst keine sensiblen Aktionen aus.
Empfangszustände
Das Modul unterscheidet Zuweisung, Warten, Empfang, abgeschlossen, storniert, abgelaufen und fehlgeschlagen. Die Zuweisung kann ohne Nummer ausstehen; echtes Warten und Empfang erfordern die Nummer und das Ablaufdatum vom Backend.
Jede Nachricht hat eine stabile Kennung, Zeitstempel und Text. Das Backend kann einen extrahierten Code bereitstellen; die Schnittstelle darf keinen OTP erraten. Das öffentliche Verzeichnis enthält keine zugewiesene Telefonnummer oder privaten Code.
Autorisierte Aktionen und Aktualisierungen
GET /activations und GET /activations/:id sind private Lesezugriffe. POST /activations/:id/actions sendet Abbruch, Abschluss oder erneutes Senden mit einem Idempotenzschlüssel. Das Backend kündigt erlaubte Aktionen an und prüft sie erneut.
Private Lesevorgänge verwenden die Sitzung, die Schnittstellensprache und geeignetes Caching. Tracking-Intervalle folgen dem Vertrag; Serverablauf und Zustand haben Vorrang vor einem Browser-Timer.
Zahlung, Zuweisung und Anbietergeheimnisse
Die Rechnung fixiert Vermögenswert, Netzwerk, Betrag, Adresse und Ablauf. Zahlungsbestätigung und Nummernzuweisung sind getrennte Ereignisse. Das Backend behandelt Fehler und Wiederholungen ohne doppelte Zuweisung.
Anbieterschlüssel und Zahlungsgeheimnisse verbleiben auf dem Server. Die API autorisiert jede Kontoabfrage, definiert die Nachrichtenaufbewahrung und hält interne Anbieterkennungen privat. Diese Seite dokumentiert den Integrationsvertrag und kündigt keine öffentliche Betriebs-API an.
Vertragsendpunkt-Referenz
| Methode | Endpunkt | Rolle |
|---|---|---|
GET | /catalog/products | Öffentlicher Katalog |
GET | /activations | Kontoaktivierungen |
GET | /activations/:id | Private Empfangsnachverfolgung |
POST | /activations/:id/actions | Autorisierte Aktion |
Dies sind die vorhandenen Frontend-Vertragspfade, keine veröffentlichten Produktionsendpunkte. Anbieter-, Authentifizierungs- und Zahlungsintegration müssen noch verbunden werden.