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\Result\AddressBookPage döndürür. Onun listAll metodu tek bir OpenEmail\Result\AddressBook döndürür.

appHost kendi başına bir ad alanıdır: $client->appHost. 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ı, isStepUpRequired() değeri true olan bir 403 fırlatır.

branding bu markayı ayarlar. branding->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. branding->update yazı tiplerini ve arka planı değiştirir, branding->uploadImage($variant, $data, contentType: ...) dört görselden birini yükler, branding->removeImage($variant) ise birini kaldırır. Varyant mark, wordmark, wordmark-dark ya da login-background olur ve OpenEmail\Constants\BrandImageVariants bunları adlandırır. Veri bir bayt dizesi, bir akış kaynağı, bir SplFileInfo ya da bir PSR-7 akışı veya yüklenmiş dosyadır. new \SplFileInfo('logo.svg') gibi bir SplFileInfo, bir dosya üzerinde açılmış bir akış ya da bir Laravel veya Symfony yüklemesi türünü kendisiyle getirir. Diğer baytlar contentType: 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 ApiException 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 ValidationException olarak, her 409 ise ConflictException 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, API'nin camelCase adlarıyla anahtarlanmış tek bir dizidir; bu yüzden tracking_host gibi bir anahtar 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 anahtar isteğe bağlıdır ve metot başvurusu her birini anlatır. İstemci update çağrısını bir okuma gibi yeniden dener, çünkü bir tekrar konağı zaten ayarlanmış bulur ve en fazla onu yeniden denetler.