تخطَّ إلى المستندات
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 إلا حين يشمل النطاق كله.

المرجع