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

فهرست امضاها

همهٔ امضاهای فضای کاری، یا امضاهای یک نشانی.

GET/signatures

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

GET /signatures

همهٔ امضاهای فضای کاری، یا امضاهای یک نشانی.

نمونه

به settings:read نیاز دارد. هر نشانی فهرستی از امضاهای نام‌دار نگه می‌دارد. بدون address فهرست همهٔ نشانی‌ها را دارد، مرتب‌شده بر اساس نشانی و سپس از قدیمی‌ترین. با آن، فقط امضاهای همان نشانی، یا امضاهای یک catch-all که به شکل *@acme.com نوشته می‌شود.

curl
curl "$OE/[email protected]" -H "$AUTH"
پاسخ
{  "object": "list",  "data": [    {      "object": "signature",      "id": "sig_2b7e9c41d0a54f3e8c6d1a90",      "address": "[email protected]",      "name": "Work",      "html": "<p>Ada Lovelace<br />Head of Research, Acme Ltd</p>",      "isDefault": true,      "isReplyDefault": false,      "createdAt": "2026-09-02T08:14:03.117Z",      "updatedAt": "2026-10-01T10:05:12.031Z"    },    {      "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"    }  ],  "hasMore": false,  "nextCursor": null}

isDefault امضایی را نشان می‌دهد که نامهٔ تازهٔ آن نشانی دارد، و isReplyDefault امضایی را که پاسخ‌ها و بازفرست‌هایش دارند. هر کدام را حداکثر یک امضای نشانی دارد، یک امضا می‌تواند هر دو را داشته باشد، و نشانی می‌تواند هیچ‌کدام را نداشته باشد.

فهرست مثل هر فهرست دیگری با limit و cursor صفحه‌بندی می‌شود. نشانی‌ای که فقط همان تک‌امضای نسخه‌های پیشین را داشته، آن را به‌صورت یک امضا به نام Signature نشان می‌دهد که پیش‌فرض هر دو است.

کلید یا برنامه‌ای که به نشانی‌ها یا دامنه‌های خاصی محدود است فقط به امضاهای نشانی‌هایی می‌رسد که در اختیار دارد، و به امضاهای catch-all فقط وقتی که کل دامنه را در اختیار داشته باشد.

مرجع