VookMail डेवलपर API

एक सरल REST API से अपने ऐप्स में अस्थायी इनबॉक्स बनाएं और संदेश पढ़ें। रिस्पॉन्स JSON में मिलते हैं।

ऑथेंटिकेशन

अपनी API कुंजी Authorization हेडर में भेजें। कुंजियाँ साइट के मालिक जारी करते हैं।

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

एंडपॉइंट

बेस URL: https://www.vookmail.com/api/v1

तरीका	पाथ	विवरण
GET	/domains	उपलब्ध डोमेन की सूची
POST	/mailboxes	मेलबॉक्स बनाएं। Body: यूज़रनेम और डोमेन, दोनों वैकल्पिक
GET	/mailboxes/{address}	मेलबॉक्स की जानकारी और समाप्ति
POST	/mailboxes/{address}/extend	मेलबॉक्स की अवधि बढ़ाएं
DELETE	/mailboxes/{address}	मेलबॉक्स बंद करें और उसके संदेश हटाएं
GET	/mailboxes/{address}/messages?after={id}	संदेशों की सूची, पहचाने गए कोड और लिंक के साथ
GET	/mailboxes/{address}/messages/{id}	एक संदेश पढ़ें: साफ़ किया गया HTML, टेक्स्ट और अटैचमेंट
DELETE	/mailboxes/{address}/messages/{id}	एक संदेश हटाएं
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	अटैचमेंट डाउनलोड करें

उदाहरण

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

त्रुटियाँ और सीमाएँ

त्रुटि होने पर error.code और error.message के साथ HTTP स्टेटस मिलता है। हर कुंजी की प्रति मिनट एक सीमा है; उससे ज़्यादा करने पर स्टेटस 429 मिलता है।