پرش به مستندات
API

ساختن یک امضا

افزودن یک امضای نام‌دار به یک نشانی یا یک catch-all.

POST/signatures

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

POST /signatures

افزودن یک امضای نام‌دار به یک نشانی یا یک catch-all.

نمونه

به settings:write نیاز دارد. address، name و html الزامی‌اند.

curl
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 است.

مرجع