API per sviluppatori di VookMail

Crea caselle temporanee e leggi i messaggi dalle tue app con una semplice API REST. Le risposte sono in JSON.

Autenticazione

Invia la tua chiave API nell'intestazione Authorization. Le chiavi sono rilasciate dal proprietario del sito.

curl https://www.vookmail.com/api/v1/domains \
  -H "Authorization: Bearer vk_your_key"

Endpoint

URL di base: https://www.vookmail.com/api/v1

Metodo	Percorso	Descrizione
GET	/domains	Elenca i domini disponibili
POST	/mailboxes	Crea una casella. Corpo: nome utente e dominio, entrambi facoltativi
GET	/mailboxes/{address}	Dettagli della casella e scadenza
POST	/mailboxes/{address}/extend	Prolunga la durata della casella
DELETE	/mailboxes/{address}	Chiudi la casella ed elimina i suoi messaggi
GET	/mailboxes/{address}/messages?after={id}	Elenca i messaggi, con i codici e i link rilevati
GET	/mailboxes/{address}/messages/{id}	Leggi un messaggio: HTML ripulito, testo e allegati
DELETE	/mailboxes/{address}/messages/{id}	Elimina un messaggio
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	Scarica un allegato

Esempio

curl -X POST https://www.vookmail.com/api/v1/mailboxes \
  -H "Authorization: Bearer vk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"username":"myapp"}'

{"address":"myapp@example.com","token":"...","expires_at":"2026-10-31T12:00:00+00:00"}

Errori e limiti

Gli errori restituiscono uno stato HTTP con error.code ed error.message. Ogni chiave ha un limite al minuto; superarlo restituisce lo stato 429.