API développeur VookMail
Créez des boîtes e-mail temporaires et lisez les messages depuis vos propres applications grâce à une API REST simple. Les réponses sont au format JSON.
Authentification
Envoyez votre clé API dans l'en-tête Authorization. Les clés sont délivrées par le propriétaire du site.
curl https://www.vookmail.com/api/v1/domains \
-H "Authorization: Bearer vk_your_key"Points d'accès
URL de base : https://www.vookmail.com/api/v1
| Méthode | Chemin | Description |
|---|---|---|
| GET | /domains | Lister les domaines disponibles |
| POST | /mailboxes | Créer une boîte. Corps de la requête : nom d'utilisateur et domaine, tous deux facultatifs |
| GET | /mailboxes/{address} | Détails de la boîte et date d'expiration |
| POST | /mailboxes/{address}/extend | Prolonger la durée de vie de la boîte |
| DELETE | /mailboxes/{address} | Fermer la boîte et supprimer ses messages |
| GET | /mailboxes/{address}/messages?after={id} | Lister les messages, avec les codes et liens détectés |
| GET | /mailboxes/{address}/messages/{id} | Lire un message : HTML nettoyé, texte et pièces jointes |
| DELETE | /mailboxes/{address}/messages/{id} | Supprimer un message |
| GET | /mailboxes/{address}/messages/{id}/attachments/{attachment} | Télécharger une pièce jointe |
Exemple
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"}Erreurs et limites
Les erreurs renvoient un statut HTTP avec error.code et error.message. Chaque clé est soumise à une limite par minute ; la dépasser renvoie le statut 429.