Belgelere geç
API

Bir genel anahtar yayımlayın

Gönderenlerin adreslerinizden birine gelen postayı mühürlemesini sağlar.

POST/encryption/keys

Gerçek çağrıyı çalışma alanınızda çalıştırır.

POST /encryption/keys

Gönderenlerin adreslerinizden birine gelen postayı mühürlemesini sağlar.

Örnek

emails:read gerekir. address, doğrulanmış bir alan adındaki adreslerinizden biridir; publicKey zırhlı biçimdeki OpenPGP genel anahtarı, fingerprint ise onun 40 büyük harfli onaltılık karakteridir. Anahtarla birlikte 201 döndürür.

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" }'
Yanıt
{  "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}

Bir adresin tek bir geçerli anahtarı olur. Başka birini yayımlamak 409 key_already_published olur; anahtarı değiştirmek için geçerli anahtarın parmak izini replaces içinde gönderin, yenisi geçerli olduğunda eskisi emekliye ayrılır. Eski anahtarla mühürlenmiş postalar yalnızca eski özel anahtarla okunabilir.

Bir uygulama önce doğrulama kodu ister: bir kod doğrulayana kadar çağrı 403 step_up_required ile yanıt verir. Bir API anahtarından asla istenmez.

Burada yalnızca genel anahtar taşınır. Özel anahtar onu oluşturan cihazda kalır.

Referans