Domenet dhe adresat

Dy hapësira emrash mbulojnë domenet tuaja. openemail domains menaxhon domenet e lidhura me hapësirën e punës: shtimin dhe heqjen e tyre, regjistrimet DNS që i duhen secilit, nëse mund të marrë dhe të dërgojë, catch-all-in e tij, domenet e gjurmimit dhe të skedarëve, dhe adresat në të. openemail addresses i përgjigjet një pyetjeje më të ngushtë: në emër të cilave adresa mund të dërgojë çelësi ose hyrja që po përdorni.

• —Një komandë domeni merr id-në e domenit, një UUID nga domains list ose domains create. Emri i hostit nuk pranohet në vend të saj, ndaj openemail domains get acme.com jep 404 dhe del me kodin 5.
• —Një komandë adrese merr id-në e domenit dhe pastaj id-në e adresës, një UUID nga domains list-addresses ose domains create-address.
• —domain dhe address funksionojnë gjithashtu si emra hapësirash emrash. Foljet e domenit u përgjigjen pseudonimeve të zakonshme, si ls, show, new, edit dhe rm, po ashtu edhe addresses list. Pesë foljet për adresat në një domen, si create-address, nuk kanë asnjë.
• —openemail <command> --help liston çdo argument dhe flamur me llojin e tij, fushëveprimin që i duhet thirrjes, metodën dhe shtegun, dhe çfarë kthehet. Shtoni --json për të njëjtën faqe si të dhëna.

Një domen raporton dy fakte të pavarura. receiving.verified bëhet true sapo DNS-ja publike përgjigjet me regjistrimet e tij MX dhe regjistrimin e tij TXT _openemail-challenge, dhe që atëherë merr postë. sending.status është gjendja e nënshkrimit siç e pa kontrolli i fundit: verified, pending, failed, no_identity ose unknown. sending.canSend tregon nëse një dërgim nga domeni do të pranohej tani, dhe një vendim negativ më i vjetër se një ditë numërohet si i panjohur, ndaj një skript duhet të degëzohet sipas canSend dhe jo sipas status. Për sa kohë është false, një dërgim nga domeni refuzohet me 409 domain_not_sendable.

• —domains create e kryen kontrollin e parë DNS gjatë thirrjes, ndaj çdo hyrje te records mbart tashmë një status: found, missing, ose null kur ende nuk është kontrolluar. Publikoni çdo regjistrim saktësisht siç jepet, meqë vlerat janë specifike për domenin.
• —domains verify kontrollon menjëherë. Brenda 10 sekondave nga kontrolli i fundit nuk kontrollon asgjë të re dhe e kthen domenin siç është. Te një domen i verifikuar kontrollon sërish regjistrimet e nënshkrimit, ndaj sending është i freskët.
• —domains get te një domen i paverifikuar kontrollon sërish kur kontrolli i fundit është më i vjetër se 20 sekonda, ndaj edhe kontrolli i vazhdueshëm me get funksionon dhe kërkon vetëm domains:read, ndërsa verify kërkon domains:write.
• —Një regjistrim i publikuar pak më parë mund të dojë disa minuta që të shfaqet në DNS-në publike.

Në terminal, get, create dhe verify shtypin një fushë për rresht, me blloqet e ndërthurura si receiving, sending dhe records si JSON kompakt. Shtoni --json dhe lexojini me një mjet si jq, siç bëjnë shembujt më poshtë.

domains update ndryshon tre cilësime që nuk varen nga njëri-tjetri. Një flamur që e lini jashtë nuk preket, dhe pa asnjë flamur domeni kthehet i pandryshuar.

• —Një host i ri ruhet dhe kontrollohet në të njëjtën thirrje. Publikoni një regjistrim CNAME me emrin record.name dhe vlerën record.value nga blloku tracking ose storage i përgjigjes, me çdo proxy të fikur. Konfigurimi sërish i një hosti mund t'i japë një vlerë tjetër, ndaj publikoni atë që raporton përgjigjja më e fundit.
• —Derisa të kalojë një kontroll, hosti lexohet pending dhe posta e re mban hostin e parazgjedhur të OpenEmail. Sapo kalon një, lexohet active. OpenEmail vazhdon të kontrollojë vetë, dhe një host aktiv që dështon tre kontrolle radhazi, ose kontrolli i fundit i suksesshëm i të cilit është 2 orë i vjetër, lexohet failed ndërsa posta e re kthehet te hosti i parazgjedhur.
• —Hiqni një host me null, si te --tracking-host null. Një vlerë bosh si --tracking-host= është gabim përdorimi në CLI dhe del me kodin 2.
• —Një host i ri kërkon që domeni të jetë i verifikuar, ose të paktën të jetë publikuar regjistrimi i tij TXT _openemail-challenge. Përndryshe thirrja refuzohet me 409 domain_not_verified.
• —Flamujt zbatohen me radhë: catch-all, pastaj domeni i gjurmimit, pastaj domeni i skedarëve. Një flamur i mëvonshëm që refuzohet mund të lërë të ruajtur një ndryshim të mëparshëm, ndaj dërgojini në thirrje të veçanta kur secili duhet të qëndrojë më vete.

Një domen mban adresat e krijuara me dorë ose përmes API-t, dhe ato që catch-all-i i tij kapi kur mbërriti posta e parë për to. list-addresses tregon të dyja llojet, përfshirë ato të çaktivizuara. Vetë catch-all-i nuk është rresht: është receiving.catchAll te domeni.

• —create-address merr --local-part, pjesën para @, dhe një --label opsionale. Domeni nuk ka nevojë të jetë ende i verifikuar, por adresa nuk merr asgjë derisa të jetë. * më vete refuzohet, sepse kështu shkruhet catch-all-i.
• —Krijimi i një adrese që ekziston tashmë, ose i një adrese që u hoq, nuk është gabim. Kthehet e aktivizuar, me etiketën që dërguat ose pa etiketë, dhe e mban id-në e vet. Një adresë që e kapi catch-all-i bëhet adresë e krijuar me dorë, ndaj vazhdon të marrë postë edhe pasi catch-all-i fiket.
• —Me catch-all të ndezur, një adresë e re nis me cilësimet për adresë të catch-all-it, si nënshkrimi dhe gjurmimi, përveç cilësimeve të privatësisë. Ato kopjohen një herë dhe nuk mbahen të sinkronizuara.
• —update-address --no-enabled e ndal adresën nga marrja e postës, ndaj dërguesit marrin një kthim, dhe asgjë nuk mund të dërgohet prej saj. Ajo i mban postën, cilësimet dhe njerëzit që mund ta arrijnë, dhe --enabled vazhdon nga aty ku mbeti. --label e riemërton, dhe --label null e heq emrin.
• —delete-address shkon më tej. Posta te adresa refuzohet edhe me catch-all të ndezur, përcjellja e saj ndalet, cilësimet e saj fshihen, njerëzit që kishin qasje në të e humbasin atë qasje, dhe hyrja e saj me fjalëkalim revokohet. Posta që ka marrë tashmë mbetet në kutinë postare. Krijimi i saj sërish rikthen të njëjtën id, pa cilësimet ose qasjen e vjetër.

openemail addresses list i përgjigjet pyetjes pas një 403 from_address_forbidden: cilat adresa mund të vendosë te From çelësi ose hyrja me të cilën po thërrisni. Kërkon emails:send dhe jo një fushëveprim leximi, sepse përshkruan atë që do të pranonte një dërgim.

• —Në terminal shtyp dy tabela: adresat, secila me informacionin nëse është e aktivizuar dhe nëse mund të dërgoni prej saj, pastaj domenet, secili me informacionin nëse është i verifikuar për marrje dhe për dërgim, dhe catch-all-in e tij.
• —unrestricted është true kur kredenciali nuk ngushtohet nga asgjë. Atëherë mund të dërgohet nga çdo local-part në domenet e hapësirës së punës, përfshirë ato që nuk i ka krijuar askush. Përndryshe canSend është true vetëm për një adresë të aktivizuar që e mbulon kredenciali, përmes një domeni të tërë që mban ose listës së vet të adresave.
• —canSend është false për një adresë të çaktivizuar, për një që kredenciali nuk e mbulon, dhe për një domeni i së cilës nuk mund të nënshkruajë ende.
• —Listohen vetëm adresat e krijuara. Një kredencial që mban një domen të tërë mund të dërgojë përsëri si çdo local-part në të, dhe nga një adresë në listën e tij pa kuti postare pas saj mund të dërgohet pa u shfaqur këtu.
• —Me --json shtyp { unrestricted, addresses, domains, hasMore, nextCursor } për një faqe, dhe { unrestricted, addresses, domains } me --all, në vend të dokumentit { items, hasMore, nextCursor } që shtypin listat e tjera. Me --all në një pipe, ose me --ndjson, shtyp një adresë për rresht.

openemail status lexon njëkohësisht hyrjen tuaj, addresses list dhe domains list dhe i shtyp bashkë. Tabela e tij Sender addresses tregon çdo adresë me informacionin nëse mund të dërgojë dhe nëse është e aktivizuar. Tabela e tij Domains tregon çdo domen si verified ose not verified për marrjen, statusin e dërgimit dhe catch-all-in e tij. Tregon 100 të parët e secilës dhe emërton komandën --all për të tjerët.

• —Një pjesë që kredenciali juaj nuk mund ta lexojë, si domenet pa domains:read ose adresat pa emails:send, thotë Not available me arsyen, dhe pjesa tjetër shtypet përsëri.
• —Kur ende nuk ka adresa, sugjeron openemail domains create --domain example.com.
• —openemail status --json shtyp një objekt me account, addresses, domains dhe unavailable, ku unavailable jep arsyen për çdo pjesë që nuk mund të lexohej.

Lidhja e një ofruesi DNS, që regjistrimet e një domeni të ri të shkruhen për ju, bëhet vetëm në aplikacionin web në 0.0.2. openemail open providers, ose open dns, e hap atë faqe. open domains hap domenet dhe regjistrimet e tyre DNS, dhe open addresses adresat. Përcjellja është gjithashtu në aplikacionin web, dhe open forwarding <address> e hap për një adresë. --print shtyp lidhjen në vend që të hapë një shfletues.

openemail domains create --domain acme.com --json > acme.jsonjq -r '.records[] | [.type, .name, .value, (.priority // "")] | @tsv' acme.jsonopenemail domains verify "$(jq -r .id acme.json)"

id=b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6funtil openemail domains get "$id" --json | jq -e .receiving.verified > /dev/null; do  sleep 30doneopenemail domains get "$id" --json | jq '.sending | {status, canSend, error}'

openemail domains list-addresses "$id" --allopenemail domains create-address "$id" --local-part invoices --label Invoicesopenemail domains update "$id" --no-catch-all --dry-runopenemail domains update "$id" --no-catch-all

Krijimi me dorë i invoices e mban atë duke marrë postë pasi catch-all-i fiket, ndërsa posta te çdo adresë tjetër që kapi catch-all-i refuzohet. Ekzekutimi provë shtyp PATCH dhe trupin e tij pa e dërguar.

openemail domains update "$id" --tracking-host links.acme.com --json | jq '.tracking | {status, record, error}'openemail domains update "$id" --tracking-host null

address_id=$(openemail domains list-addresses "$id" --all | jq -r 'select(.address == "[email protected]") | .id')openemail domains update-address "$id" "$address_id" --no-enabledopenemail domains delete-address "$id" "$address_id" --yes

Fikja e adresës së pari mund të zhbëhet me --enabled. Fshirja jo, dhe në një skript kërkon --yes. Me një hyrje me shfletues kërkon edhe një kod verifikimi, të cilin --yes nuk e kapërcen kurrë.

openemail domains list --all | jq -r 'select(.sending.canSend | not) | [.domain, .sending.status] | @tsv'openemail addresses list --all --json | jq -r '.addresses[] | select(.canSend) | .address'

• —Një hyrje ose çelës pa fushëveprimin ndalet me kodin e daljes 4, emërton fushëveprimin që mungon dhe tregon si ta merrni.
• —domains delete dhe domains delete-address kërkojnë konfirmim. Përgjigjja jo del me kodin 10 dhe nuk ndryshon asgjë. Pa mbikëqyrje dhe pa --yes, ndalen me kodin e daljes 2 para se të dërgohet ndonjë gjë.
• —Me një hyrje me shfletues, këto dy fshirje kërkojnë gjithashtu një kod verifikimi, si aplikacioni web. Pa mbikëqyrje askush nuk mund ta shkruajë, ndaj komanda ndalet me kodin e daljes 4. Ekzekutoni fillimisht openemail verify dhe 60 minutat e ardhshme nuk kërkojnë kod. Një çelësi API nuk i kërkohet kurrë.
• —--dry-run shtyp kërkesën që do të dërgonte një ndryshim, me trupin e saj, dhe del me kodin 0 pa e dërguar dhe pa ju kërkuar konfirmim.
• —Një listë lexon një faqe: --limit merr nga 1 deri në 100 dhe serveri dërgon 25 kur lihet jashtë, dhe --cursor merr nextCursor e faqes së mëparshme. --all lexon çdo faqe, --max <n> ndalet pas aq elementeve, dhe --ndjson, ose --all në një pipe, shtyp një objekt JSON për rresht. Me --json, domains list dhe list-addresses shtypin një dokument të vetëm { items, hasMore, nextCursor }.
• —Një çelës ose hyrje e kufizuar në domene ose adresa të caktuara sheh përsëri çdo domen dhe adresë. Nuk mund të shtojë domen, dhe çdo ndryshim tjetër kërkon që i gjithë domeni të jetë midis domeneve që mban, përndryshe thirrja refuzohet me 422 capability_unsupported.
• —Një refuzim del me kodin e statusit të vet: 4 për një 403, si domain_allowance_reached kur plani nuk lejon më domene, 5 për një 404, 6 për një 409, si domain_already_added ose domain_claimed, dhe 7 për një 422, si invalid_tracking_host ose workspace_limit_reached.
• —Domeni i fundit në një hapësirë pune nuk mund të hiqet nga CLI. Kjo jep 409 last_domain, sepse heqja e tij fshin gjithë kutinë postare, gjë që aplikacioni web e konfirmon më parë. Një domen që mban adresa të rezervuara të llogarisë jep 409 domain_holds_reserved_addresses.
• —domains create dhe dy fshirjet nuk riprovohen kurrë pas një dështimi rrjeti. Një 409 domain_already_added, ose një 404 në përpjekjen tuaj të dytë pas një përgjigjeje të humbur, do të thotë se e para funksionoi. verify, update, create-address dhe update-address riprovohen vetë, meqë dërgimi dy herë i njërës prej tyre lë të njëjtin rezultat.