ساختن یک امضا
افزودن یک امضای نامدار به یک نشانی یا یک 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 است.