Alan adları

get alan adındaki adresleri de listeler. İlgili çağrı addresses.list'tir: bu anahtarın bir From başlığına koyabileceği, daha dar kapsamlı adresler; her biri bir canSend sonucuyla birlikte. Bunları items yerine addresses içinde, domains ve unrestricted yanında tutan bir OpenEmail::AddressBookPage döndürür. Onun list_all metodu tek bir OpenEmail::AddressBook döndürür.

app_host kendi başına bir ad alanıdır: client.app_host. get, set, verify ve delete, çalışma alanının web uygulaması adresini okur ve değiştirir: bu alan adlarından birinde ya da çalışma alanının denetimindeki başka herhangi bir alan adında, çalışma alanındaki kişilerin çalışma alanının markasıyla oturum açtığı mailbox.acme.com gibi bir alt alan adı. set yayımlanacak DNS kayıtlarını record içinde ve çalışma alanının dışındaki bir alan adında ayrıca ownershipRecord içinde döndürür. delete ve bir adresi değiştiren set, bir OAuth uygulamasından doğrulama kodu ister: kod alınana kadar çağrı, step_up_required? değeri true olan bir 403 fırlatır.

branding bu markayı ayarlar. get; amblemin, logonun, karanlık mod logosunun ve oturum açma fotoğrafının bağlantılarını, iki yazı tipini ve oturum açma arka planını okur. update yazı tiplerini ve arka planı değiştirir, upload_image(variant, data, content_type: nil) dört görselden birini yükler, remove_image(variant) ise birini kaldırır. variant değeri mark, wordmark, wordmark-dark ya da login-background olur ve OpenEmail::BRAND_IMAGE_VARIANTS bunları adlandırır. data ikili bir String, bir IO ya da bir Pathname'dir. Pathname("logo.svg") gibi bir Pathname, bir File ya da bir Rails yüklemesi türünü kendisiyle getirir. Diğer baytlar content_type: gerektirir ve türü olmayan bir görsel 422 invalid_image ile reddedilir. Web uygulaması adresine ve ücretli bir planda çalışma alanı adına gönderilen e-postalara markasını veren şey logodur.

Reddedilen bir konak, param içinde trackingHost belirten bir OpenEmail::ApiError fırlatır: kullanılamayan bir ad için (örneğin alan adının dışındaki bir ad) 422 invalid_tracking_host; receiving.verified false iken ve alan adının _openemail-challenge TXT kaydı henüz yayımlanmamışken yeni bir konak için 409 domain_not_verified; başka bir alan adının zaten kullandığı bir ad için ya da izleme alan adı farklı bir OpenEmail sunucusu tarafından yönetiliyorsa 409 tracking_host_in_use. 422 OpenEmail::ValidationError olarak, her 409 ise OpenEmail::ConflictError olarak gelir. Belirli adreslerle sınırlı bir anahtar 422 capability_unsupported alır, çünkü bir izleme alan adı alan adındaki her adrese uygulanır.

Değişiklik anahtar kelime argümanları ya da tek bir Hash'tir ve alanları API'nin camelCase adlarını korur; bu yüzden tracking_host: yazıldığı gibi gönderilir ve 422 unknown_parameter ile reddedilir. update ayrıca catchAll, files.acme.com gibi bir dosya alan adı için storageHost ve dmarcPolicy alır. Her alan isteğe bağlıdır ve metot başvurusu her birini anlatır. Gem update çağrısını bir okuma gibi yeniden dener, çünkü bir tekrar konağı zaten ayarlanmış bulur ve en fazla onu yeniden denetler.