VookMail API for utviklere

Opprett midlertidige innbokser og les meldinger fra dine egne apper med et enkelt REST API. Svarene er i JSON.

Autentisering

Send API-nøkkelen din i Authorization-headeren. Nøklene utstedes av eieren av nettstedet.

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

Endepunkter

Basis-URL: https://www.vookmail.com/api/v1

Metode	Sti	Beskrivelse
GET	/domains	List de tilgjengelige domenene
POST	/mailboxes	Opprett en postkasse. Innhold: brukernavn og domene, begge valgfrie
GET	/mailboxes/{address}	Detaljer om postkassen og når den utløper
POST	/mailboxes/{address}/extend	Forleng levetiden til postkassen
DELETE	/mailboxes/{address}	Lukk postkassen og slett meldingene i den
GET	/mailboxes/{address}/messages?after={id}	List meldinger, med oppdagede koder og lenker
GET	/mailboxes/{address}/messages/{id}	Les én melding: renset HTML, tekst og vedlegg
DELETE	/mailboxes/{address}/messages/{id}	Slett én melding
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	Last ned et vedlegg

Eksempel

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"}

Feil og grenser

Feil gir en HTTP-status med error.code og error.message. Hver nøkkel har en grense per minutt, og hvis du overskrider den, får du status 429.