تخطَّ إلى المستندات
API

نسخ توقيع إلى عناوين أخرى

ضع التوقيع نفسه على عناوين أخرى، مستبدلًا التوقيع الذي يحمل الاسم نفسه هناك.

POST/signatures/{id}/copy

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

POST /signatures/{id}/copy

ضع التوقيع نفسه على عناوين أخرى، مستبدلًا التوقيع الذي يحمل الاسم نفسه هناك.

مثال

يتطلب settings:write. يقبل addresses من 1 إلى 500 عنوان أو catch-all.

curl
curl -X POST "$OE/signatures/sig_8f2c1a9b7d3e4f60a1b2c3d4/copy" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "addresses": ["[email protected]", "[email protected]"], "isDefault": true }'
الاستجابة
{  "object": "list",  "data": [    {      "object": "signature",      "id": "sig_51c0a7e2b94d4c18a3f6e0d2",      "address": "[email protected]",      "name": "Short",      "html": "<p>Ada<br />Acme Ltd</p>",      "isDefault": true,      "isReplyDefault": false,      "createdAt": "2026-10-12T09:20:41.902Z",      "updatedAt": "2026-10-12T09:20:41.902Z"    },    {      "object": "signature",      "id": "sig_c9d4e1f07a2b4b6f9e3d5a81",      "address": "[email protected]",      "name": "Short",      "html": "<p>Ada<br />Acme Ltd</p>",      "isDefault": true,      "isReplyDefault": true,      "createdAt": "2026-10-12T09:20:41.955Z",      "updatedAt": "2026-10-12T09:20:41.955Z"    }  ]}

العنوان الذي لديه بالفعل توقيع بالاسم نفسه، دون اعتبار لحالة الأحرف، يُستبدل HTML ذلك التوقيع فيه، فالنسخ مجددًا بعد تعديل يحدّث كل النسخ. وأي عنوان آخر يحصل على توقيع جديد بذلك الاسم.

تصير النسخة افتراضية حيث يكون isDefault أو isReplyDefault يساوي true، وافتراضية للاثنين على عنوان لم يكن له أي توقيع. وإن لم يُحدَّدا، بقيت التوقيعات الافتراضية للعناوين الأخرى كما هي. ويُتخطّى العنوان الذي عليه التوقيع أصلًا.

كل نسخة تصير منذئذٍ توقيعًا مستقلًا، له معرّفه الخاص. وتُكتب النسخ عنوانًا بعد عنوان، فإذا امتلأ عنوان فشل الاستدعاء بـ422 signature_limit_reached واحتفظت العناوين التي قبله بنسختها.

المرجع