API Uyumluluğu

Sürümleme taahhüdüBölüm bağlantısını kopyala

API sürümü URL yolunda belirtilir. Bugün yalnızca /v1 vardır.

• v1 değişiklikleri yalnızca ekleyicidir. Endpoint, isteğe bağlı istek alanı, yanıt alanı ve olay türü ekleriz. Bir alanı kaldırmaz, adını veya anlamını değiştirmez, isteğe bağlı bir alanı zorunlu yapmayız. İstemciniz tanımadığı yanıt alanlarını yok saymalıdır.
• Uyumsuz değişiklik /v2 olarak yayımlanır. Kullanıma açılmadan en az 180 gün önce duyururuz ve /v1, /v2 yayımlandıktan sonra 180 gün boyunca onunla birlikte çalışmaya devam eder.

Alıcı başına ayrı kopyaBölüm bağlantısını kopyala

POST /v1/transactional/send isteğinin to alanında birden fazla alıcı varsa her alıcı, kendi mesaj kimliğiyle iletinin ayrı bir kopyasını alır. Ortak bir ileti yoktur ve görünür Cc yoktur: hiçbir alıcı diğerlerinin adreslerini görmez. İstek cc veya bcc kabul etmez. Tüm alıcıların birbirini görmesi gerekiyorsa v1'de bu mümkün değildir.

Ek boyutuBölüm bağlantısını kopyala

Bir ileti en fazla 10 ek ve Base64 çözüldükten sonra ölçülen toplam en fazla 10 MiB taşıyabilir. Sınırı aşan istek 400 VALIDATION_FAILED ile reddedilir. Bkz. Ekler.

Idempotency kapsamıBölüm bağlantısını kopyala

X-Idempotency-Key yalnızca iki endpoint'te kabul edilir: POST /v1/transactional/send ve POST /v1/transactional/send-batch. Başka hiçbir endpoint bunu okumaz; bu yüzden diğer herhangi bir POST'u yeniden denemek etkisini tekrarlayabilir. Bkz. Idempotency.