Scheiding van openbare catalogus en privéontvangst
Openbare gegevens beschrijven service, land, prijs en duur. Ze bevatten geen toegewezen telefoonnummer of code. Activaties behoren tot een account en bestelling met aparte privé-tracking.
De dienst- en landengids is gescheiden van commerciële aanbiedingen. Het integratiecontract vereist een API-catalogus met gezaghebbende prijs en beschikbaarheid voor bestellingen.
Catalogus en bestellen
Het bestaande contract specificeert GET /catalog/products en GET /catalog/products/:slug. De backend levert gezaghebbende prijs, duur en expliciete beschikbaarheid; ontbrekende voorraad blijft onbekend.
Bestellingen sturen een productidentificator met een idempotentiesleutel. De server controleert prijs en voorraad vóór reservering of toewijzing. Het lezen van een pagina triggert geen gevoelige acties.
Ontvangststatussen
De module onderscheidt toewijzing, wachten, ontvangen, voltooid, geannuleerd, verlopen en mislukt. Toewijzing kan in afwachting zijn zonder nummer; echt wachten en ontvangst vereisen het nummer en de vervaldatum van de backend.
Elk bericht heeft een stabiele identificatie, tijdstempel en tekst. De backend kan een geëxtraheerde code leveren; de interface mag geen OTP raden. De openbare directory bevat geen toegewezen telefoonnummer of privécode.
Geautoriseerde acties en updates
GET /activations en GET /activations/:id zijn privé-leesacties. POST /activations/:id/actions verzendt annuleren, voltooien of opnieuw verzenden met een idempotentiesleutel. De backend kondigt toegestane acties aan en controleert ze opnieuw.
Privélezingen gebruiken de sessie, interface-taal en geschikte caching. Volgintervallen volgen het contract; serververval en status hebben prioriteit boven een browsertimer.
Betalings-, toewijzings- en providersgeheimen
De factuur legt activa, netwerk, bedrag, adres en vervaldatum vast. Betalingsbevestiging en nummerallocatie zijn aparte gebeurtenissen. De backend behandelt fouten en herhalingen zonder dubbele toewijzing.
Provider-sleutels en betalingsgeheimen blijven op de server. De API autoriseert elke accountlezing, definieert berichtbewaring en houdt interne provideridentificaties privé. Deze pagina documenteert het integratiecontract en kondigt geen operationele openbare API aan.
Contract eindpuntreferentie
| Methode | Eindpunt | Rol |
|---|---|---|
GET | /catalog/products | Publieke catalogus |
GET | /activations | Accountactivaties |
GET | /activations/:id | Privé ontvangsttracking |
POST | /activations/:id/actions | Geautoriseerde actie |
Dit zijn de bestaande frontend contractpaden, geen gepubliceerde productie-eindpunten. Provider-, authenticatie- en betalingsintegratie moeten nog worden verbonden.