Separa catalogo pubblico da ricezione privata
I dati pubblici descrivono servizio, paese, prezzo e durata. Non contengono numeri telefonici o codici allocati. Le attivazioni appartengono a un account e ordine con tracciamento privato separato.
La directory di servizi e paesi è separata dalle offerte commerciali. Il contratto di integrazione richiede un catalogo API con prezzi e disponibilità autorevoli per gli ordini.
Catalogo e ordinazione
Il contratto esistente specifica GET /catalog/products e GET /catalog/products/:slug. Il backend fornisce prezzo, durata e disponibilità esplicita autorevoli; la mancanza di stock rimane sconosciuta.
Gli ordini inviano un identificatore prodotto con una chiave di idempotenza. Il server controlla prezzo e stock prima della prenotazione o allocazione. La lettura di una pagina non attiva azioni sensibili.
Stati di ricezione
Il modulo distingue assegnazione, attesa, ricevuto, completato, annullato, scaduto e fallito. L'assegnazione può essere in sospeso senza numero; l'attesa reale e la ricezione richiedono il numero e la scadenza del backend.
Ogni messaggio ha un identificatore stabile, un timestamp e un testo. Il backend può fornire un codice estratto; l'interfaccia non deve indovinare un OTP. La directory pubblica non contiene numeri di telefono assegnati né codici privati.
Azioni autorizzate e aggiornamenti
GET /activations e GET /activations/:id sono letture private. POST /activations/:id/actions invia annulla, termina o rinvia con una chiave di idempotenza. Il backend annuncia e ricontrolla le azioni consentite.
Le letture private usano la sessione, la lingua dell'interfaccia e una cache adatta. Gli intervalli di tracciamento seguono il contratto; la scadenza del server e lo stato hanno priorità su un timer del browser.
Pagamento, assegnazione e segreti del fornitore
La fattura fissa asset, rete, importo, indirizzo e scadenza. La conferma di pagamento e l'allocazione del numero sono eventi separati. Il backend gestisce errori e tentativi senza doppia allocazione.
Le chiavi del fornitore e i segreti di pagamento restano sul server. L'API autorizza ogni lettura account, definisce la conservazione dei messaggi e mantiene privati gli identificatori interni del fornitore. Questa pagina documenta il contratto di integrazione e non annuncia un'API pubblica operativa.
Riferimento endpoint contratto
| Metodo | Endpoint | Ruolo |
|---|---|---|
GET | /catalog/products | Catalogo pubblico |
GET | /activations | Attivazioni account |
GET | /activations/:id | Tracciamento ricezione privato |
POST | /activations/:id/actions | Azione autorizzata |
Questi sono i percorsi contrattuali frontend esistenti, non endpoint di produzione pubblicati. Rimangono da collegare provider, autenticazione e integrazione pagamento.