إنشاء توقيع
أضف توقيعًا مسمّى إلى عنوان أو إلى catch-all.
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
POST /signatures
أضف توقيعًا مسمّى إلى عنوان أو إلى catch-all.
مثال
يتطلب settings:write. الحقول address وname وhtml إلزامية.
curl -X POST "$OE/signatures" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "address": "[email protected]", "name": "Short", "html": "<p>Ada<br>Acme Ltd</p>", "isReplyDefault": true }'{ "object": "signature", "id": "sig_8f2c1a9b7d3e4f60a1b2c3d4", "address": "[email protected]", "name": "Short", "html": "<p>Ada<br />Acme Ltd</p>", "isDefault": false, "isReplyDefault": true, "createdAt": "2026-10-12T09:14:03.117Z", "updatedAt": "2026-10-12T09:14:03.117Z"}يُنقّى HTML كما يُنقّى البريد الصادر، فقد يختلف ما يعود عمّا أرسلته، ويجب أن يبقى فيه نص أو صورة. ويقبل 150,000 حرف على الأكثر، قبل التنقية وبعدها، وإلا أعطى الاستدعاء 422 signature_too_long.
أول توقيع لعنوان يصير توقيعه الافتراضي للبريد الجديد وللردود ما لم يكن isDefault أو isReplyDefault يساوي false. والتوقيع اللاحق لا يصير افتراضيًا إلا عند الطلب، وعندها يأخذ ذلك الموضع من التوقيع الذي كان يشغله.
name من 1 إلى 80 حرفًا وفريد على عنوانه، دون اعتبار لحالة الأحرف. والاسم الذي يستخدمه العنوان بالفعل يعطي 409 signature_name_taken. ويتّسع العنوان لـ50 توقيعًا على الأكثر، والتوقيع الذي يلي ذلك يعطي 422 signature_limit_reached.
يجب أن يكون العنوان أحد عناوين مساحة العمل، أو catch-all على نطاق موثّق هنا وخاصية catch-all فيه مفعَّلة. وأي شيء آخر، ومنه النطاق الكامل، يعطي 422 invalid_parameter.