Bilgi bankası
REST API
Üretilebilir, kapsamlandırılabilir ve iptal edilebilir anahtarlarla belgelenmiş bir HTTP API'si.
Ayrıntılar
- Her yerde açık. API, 68 yol üzerinde 104 belgelenmiş işlem sunar (e-postalar, konu zincirleri, taslaklar, etiketler, kişiler, kitleler, alan adları, şablonlar, kurallar, roller, üyeler, ayarlar, takvim, izleme, webhook'lar ve hesap); bunların arkasında, GET /openapi.json adresinden anahtarsız okuyabileceğiniz, taahhüt edilmiş bir OpenAPI 3.1 belgesi vardır. Erişime, Ayarlar'da ürettiğiniz çalışma alanı anahtarı karar verir.
- Bunun eskiden beklediği dayanıklılık artık tamam. Bir gönderim, herhangi bir şey sevk edilmeden önce msg_ ve ardından 24 onaltılık karakter biçiminde açık bir id ile bir satır yazar; GET /emails/{id} bunu çözümler, alıcı bazlı iz için /events ve açılma ile tıklamalar için /tracking da yanında gelir. 1–255 karakterlik bir Idempotency-Key, anahtarın ve API anahtarınızın birlikte oluşturduğu benzersiz bir dizin üzerinden sahiplenilir; böylece bir zaman aşımından sonraki yeniden deneme, iki kez göndermek yerine ilk sonucu Idempotency-Replayed: true ile döndürür. Anahtarla yapılan bir gönderim, iş oturduktan sonra 200, hâlâ kuyruktaysa ya da zamanlanmışsa 202 yanıtı verir.
- Anahtarlar Ayarlar → API anahtarları bölümünde üretilir, kapsamlandırılır, döndürülür ve iptal edilir. Konsolun ürettiği her anahtar bir oe_live_ anahtarıdır. oe_test_ öneki doğrulayıcı tarafından ve gönderim yolu tarafından anlaşılır; orada test modundaki bir gönderim hiçbir taşıyıcıya ulaşmadan kaydedilir ve gönderilmiş olarak yanıtlanır, ama henüz hiçbir şey böyle bir anahtar üretemez ve no-op taşıyıcı Durable Object'in üzerine oturmadan bu seçeneği sunmak, size gerçekten teslimat yapan bir test anahtarı vermek olurdu. Bir anahtar, en fazla 25 tam alan adı ve 50 tekil adresten oluşan bir gönderim kapsamı taşır; burada bir tam alan adı, ona sonradan eklenen adresleri de kapsar. Ayrıca 1 ile 3650 gün arasında isteğe bağlı bir son kullanma tarihi ve isteğe bağlı bir rol taşır. Rol ikinci bir yetki değil bir tavandır: GET /ping hem anahtardaki kapsamları hem de rolün ona bıraktığı kapsamları döndürür; böylece anahtarınızın açıkça adını taşıdığı bir kapsam için alınan 403'ün görünür bir nedeni olur. İptal etmek silme değil bir güncellemedir; böylece sonraki bir çağrıya, yalnızca kimlik doğrulamada başarısız olmak yerine revoked_api_key denir. Döndürme, anahtarla ilgili gizli dizi dışındaki her şeyi korur: id, kapsamlar, gönderim kapsamı ve istek geçmişi devam eder, eski gizli dizi yenisi üretildiği anda ölür ve keys:write taşıyan bir anahtar kendini API üzerinden döndürebilir. Aynı listeleme, döndürme, iptal ve etkinleştirme eylemleri, rolü anahtar yönetimine izin veren herkes için MCP sunucusunda da bulunur.
- Gerçekten eksik olan: API'nin kendine ait bir yükleme uç noktası yok. Satır içi ekler 5 MB'lık toplam sınırla base64 olarak gider; daha büyük bir dosya ise çalışma alanında zaten bulunan bir dosyayı id'siyle adlandırarak gönderilir ve bir indirme bağlantısı olarak yol alır. Geri dönen iletiler, gönderim günlüğünde değil posta kutusunda ele alınır: bir teslimat raporu ayrıştırılır, Message-ID üzerinden aslıyla eşleştirilir, konu zincirinde etiketlenir ve bir email.bounced webhook'u olarak iletilir, ama hiçbir şey gönderim satırına geri yazmaz; o satırın durumunda bounced diye bir hal yoktur, dolayısıyla GET /emails üzerinden geri dönen bir ileti hâlâ sent olarak okunur. Uygulamanın ileti yazma penceresinden gönderilen posta da GET /emails içinde görünmez, çünkü o pencere aynı gönderim yolu üzerinden yazmaz.