Gelen kutusu oluştur
Bir adres üretir ve onu okuyan token'ı döndürür. Gövde dahil her alan isteğe bağlıdır.
Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.
POST /temp-mail/inboxes
Bir adres üretir ve onu okuyan token'ı döndürür. Gövde dahil her alan isteğe bağlıdır.
Kimlik bilgisi yok
export OE=https://api.openemail.ukHiç Authorization başlığı göndermeyin. API üzerinde bu başlık olmadan yanıt veren tek kaynak budur. Bir kapsam verilmek yerine anahtar denetiminin üstüne kaydedilmiştir; çünkü burada sunulan şey, anahtarı olmayan birine verilen bir adrestir ve önce anahtar istemek bunu araç kılığına girmiş bir potansiyel müşteri formuna çevirirdi.
Örnek
Boş bir gövde geçerlidir ve olağan durumdur: havuzdan seçilen bir alan adı üzerinde üretilmiş bir local-part, bir saatliğine kiralanır.
curl -X POST "$OE/temp-mail/inboxes" -H "Content-Type: application/json" \ -d '{ "localPart": "octopus-signup", "ttlMinutes": 120 }'{ "object": "temp_inbox", "id": "tinb_9c2f41ab7d3e4c118a0f5d72", "address": "[email protected]", "domain": "freemailaddress.com", "createdAt": "2026-09-01T10:00:00.000Z", "expiresAt": "2026-09-01T12:00:00.000Z", "extensionsLeft": 22, "messageCount": 0, "messageLimit": 50, "lastMessageAt": null, "token": "oe_inbox_kQ8v…"}201 ve tüm API içinde token taşıyan tek yanıt. Adresle başka bir şey yapmadan önce onu saklayın.
Üretilen bir local-part, sesli harf ve birbirine benzeyen karakter içermeyen bir alfabeden alınmış on iki karakterdir; böylece hiçbir anlamlı sözcük oluşturamaz ve ekrandan okunarak aktarılmaya dayanır.
Reddedilebilecek her şey sessizce düzeltilmek yerine adıyla reddedilir: 422 unknown_domain, invalid_address, reserved_address veya 1 ile 1440 aralığı dışındaki bir ttlMinutes için invalid_parameter; halihazırda sahiplenilmiş bir local-part için 409 address_taken; üretim tavanında 429 too_many_inboxes; havuzda hiç alan adı bulunmayan bir kurulumda 503 temp_mail_unavailable.
Parametreler
Gövde
domainstring- `GET /temp-mail/domains` listesindekilerden biri. Belirtmezseniz havuz, ilk alan adını doldurmak yerine rastgele seçer. İnternetteki her tek kullanımlık kaydı tek bir alan adı karşılarsa buna yakışır bir itibar edinir ve o itibarı üzerindeki her adres paylaşır. Havuzda olmayan bir alan adı sessizce değiştirilmek yerine adıyla reddedilir (422 `unknown_domain`); çünkü istediğiniz adresi çoktan kopyalamış olurdunuz.
localPartstring- @ işaretinden önceki bölüm, seçmek isterseniz: harf, rakam, nokta, tire ve alt çizgiden oluşan 3 ila 32 karakter; bir harf veya rakamla başlar ve biter. RFC 5321'in izin verdiğinden dardır, çünkü bu dizge bir URL yoluna, bir `To:` başlığına ve bir HTML sayfasına girer. `+` dışarıda bırakılmıştır; alt adresleme giriş sırasında sadeleştirildiği için `alice+bob` size aslında ulaşılamayan bir ad olurdu. Alınmış adlar 409 `address_taken` döndürür ve bu iki durumu kapsar: adı başka bir ziyaretçi tutuyordur (ya da son bir hafta içinde tutmuştur ve adres hâlâ dolaşım dışıdır) veya alan adının sahibi onu gerçek bir adres olarak oluşturmuştur; bu da aynı kodla reddedilir, çünkü o adrese giden posta size değil ona ulaşır. `postmaster` ve diğer ayrılmış adlar 422 `reserved_address` döndürür.
ttlMinutesnumber- Kiralamanın dakika cinsinden süresi, 1 ile 1440 arasında. Varsayılan 60'tır. Bu aralığın dışındaki bir değer sessizce düzeltilmek yerine alanı adıyla belirten 422 `invalid_parameter` döndürür. İstediğiniz sona erme zamanını birine çoktan göstermiş olurdunuz. 24 saat oluşturma anından itibaren ölçülür; dolayısıyla baştan alınan her saat, sonradan harcanamayacak bir uzatmadır: `ttlMinutes: 120` 22 uzatmayla, 1440 ise hiç uzatmasız döner.
Yanıt: temp_inbox, artı bir token
idstring- Gelen kutusu id'si: `tinb_` ve yirmi dört onaltılık karakter. Diğer her çağrının yolunda yer alır ve gizli değildir. Gizli olan token'dır.
addressstring- Karşı tarafa verilecek adres. `that+anything@` biçiminde adreslenen posta da buna ulaşır, çünkü alt adresleme arama yapılmadan önce sadeleştirilir.
domainstring- Adresin üzerinde bulunduğu havuz alan adı; istemcinin göstermek için adresi ayrıştırmak zorunda kalmaması adına ayrı verilir.
createdAtstring- ISO-8601. 24 saatlik üst sınır, son uzatmadan değil buradan itibaren ölçülür.
expiresAtstring- ISO-8601. Bu anı geçtiğinde token anında kimlik doğrulamayı bırakır ve temizlik işi bir sonraki çalışmasında postayı siler.
extensionsLeftnumber- `extend` çağrısının gerçekten kaç kez daha süre kazandıracağı; her iki tavan da sayılarak: bir kiralamanın izin verdiği 23 uzatma ve `createdAt` üzerinden asla aşamayacağı 24 saat, hangisine önce ulaşılırsa. `ttlMinutes: 1440` ile oluşturulan bir gelen kutusu hiçbir şey harcamamış olmasına rağmen 0 bildirir. Sıfır, çağrının 409 döndüreceği anlamına gelir; istemci bunu düğmeye basarak keşfetmek yerine düğmeyi bu değere bakarak soluklaştırmalıdır.
messageCountnumber- Bu gelen kutusunun KABUL ETTİĞİ mesaj sayısı; görünen mesaj sayısı değil. Bir mesajı sildiğinizde azalmaz: tavan gelen mesajları sayar, dolayısıyla silmek depolama alanı açar ama kota alanı açmaz.
messageLimitnumber- Tavan değeri; istemcinin sabitimizi koda gömmeden “dolu” diyebilmesi için her gelen kutusuyla birlikte gönderilir.
lastMessageAtstring | null- Son postanın ne zaman geldiği, ISO-8601; hiç gelmediyse null. İki dakikadır bekleyen biri için yeni açılmış bir gelen kutusundaki null ile sessiz bir kutudaki null çok farklı okunur.
tokenstring- Kimlik bilgisi; yalnızca bu yanıtta bulunur. `oe_inbox_` ve 43 base64url karakteri; satırda yalnızca anahtarlı bir özet saklanır, bu yüzden yeniden okunamaz veya kurtarılamaz.
Diğer tüm gelen kutusu yanıtları (retrieve, extend) token içermeyen bu nesnedir.