दस्तावेज़ पर जाएँ
API

सार्वजनिक कुंजी प्रकाशित करें

भेजने वालों को आपके किसी पते की मेल सील करने देता है।

POST/encryption/keys

असली कॉल आपके वर्कस्पेस पर चलाता है।

POST /encryption/keys

भेजने वालों को आपके किसी पते की मेल सील करने देता है।

उदाहरण

emails:read चाहिए। address सत्यापित डोमेन पर आपका कोई पता है, publicKey armor रूप में OpenPGP सार्वजनिक कुंजी और fingerprint उसके 40 बड़े हेक्साडेसिमल अक्षर। कुंजी के साथ 201 लौटाता है।

curl
curl -X POST "$OE/encryption/keys" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "address": "[email protected]", "publicKey": "-----BEGIN PGP PUBLIC KEY BLOCK-----\n…", "fingerprint": "3F2A9C1B7E4D5F60A1B2C3D4E5F60718293A4B5C" }'
प्रतिक्रिया
{  "object": "encryption_key",  "id": "pgpk_8c1e4a7f2b9d3e6a0c5f1b28",  "address": "[email protected]",  "fingerprint": "3F2A9C1B7E4D5F60A1B2C3D4E5F60718293A4B5C",  "publicKey": "-----BEGIN PGP PUBLIC KEY BLOCK-----\n…\n-----END PGP PUBLIC KEY BLOCK-----",  "algorithm": "ed25519",  "createdAt": "2026-09-30T09:12:44.000Z",  "revokedAt": null,  "revokedReason": null}

किसी पते की एक ही चालू कुंजी रहती है। दूसरी प्रकाशित करना 409 key_already_published है, इसलिए कुंजी बदलने के लिए चालू कुंजी का फ़िंगरप्रिंट replaces में भेजें, और नई चालू होते ही वह हटा दी जाती है। पुरानी कुंजी से पहले सील की गई मेल सिर्फ़ पुरानी निजी कुंजी से पढ़ी जा सकती है।

ऐप पहले पुष्टि कोड माँगता है: जब तक वह कोई कोड सत्यापित न कर ले, कॉल 403 step_up_required लौटाती है। API कुंजी से कभी नहीं पूछा जाता।

यहाँ सिर्फ़ सार्वजनिक कुंजी जाती है। निजी कुंजी उसी डिवाइस पर रहती है जिसने उसे बनाया।

संदर्भ