I metodi da utilizzare sono principalmente 2, da usare in sequenza:
Invio Richiesta Pec: tramite il metodo POST
Richiesta Esito della Ricerca Pec: tramite il metodo GET
Per utilizzarli è sufficiente creare un form html, inserire i parametri specifici come campi “text”, valorizzandoli opportunamente e inviarli all’url del servizio.
L’url del servizio da utilizzare è: https://trovaindirizzipec.it/PecApi/index_ws.php
Abbiamo predisposto alcuni semplici form per simulare interattivamente il processo:
https://www.trovaindirizzipec.it/PecApi/index_post.html: per inviare la prima richiesta
https://www.trovaindirizzipec.it/PecApi/index_get.html: per ottenere le risposte, ovvero l’esito della ricerca.
Per verificare il saldo:
https://trovaindirizzipec.it/PecApi/check_saldo.html
Di seguito riportiamo gli schemi con tutte le caratteristiche dei metodi:
| Invio Richiesta Pec | Metodo: POST | |
| PARAMETRI | Descrizione | |
| key | La user-key associata alla vostra utenza | obbligatorio |
| cf | La partita iva o codice fiscale da cercare | obbligatorio |
| RISPOSTE | ||
| OK|CodiceToken | La richiesta è andata a buon fine viene restituito il token per il passaggio successivo | |
| Error|Richiesta già presente | Una richiesta è già presente | E’ possibile cancellare la precedente richiesta |
| Richiesta Esito Pec | Metodo: GET | |
| PARAMETRI | Descrizione | |
| key | La user-key associata alla vostra utenza | obbligatorio |
| token | Il valore ottenuto dalla richiesta precedente | obbligatorio |
| RISPOSTE | ||
| OK|pec@pec.it|stato | Richiesta processata correttamente | Esempi: Ok||pec non trovata OK|pec@pec.it|pec trovata |
| WAIT|token | E’ necessario attendere e richiedere nuovamente l’esito | La richiesta viene evasa in 2-3 minuti |
| ERROR|descrizione errore |
| Cancellazione Richiesta Pec | Metodo: POST | |
| PARAMETRI | Descrizione | |
| key | La user-key associata alla vostra utenza | obbligatorio |
| cf-delete | Il codice fiscale della richiesta da eliminare | obbligatorio |
| RISPOSTE | ||
| OK|richiesta cancellata correttamente | Richiesta cancellata correttamente |
| Richiesta Saldo Account | Metodo: POST | |
| PARAMETRI | Descrizione | |
| key | La user-key associata alla vostra utenza | obbligatorio |
| saldo | è sufficiente la presenza del campo, non deve essere valorizzato | |
| RISPOSTE | ||
| importo del saldo |