API
إنشاء عنوان
ينشئ عنوانًا على النطاق. يستقبل البريد بمجرد أن يستقبله النطاق، ويمكن الإرسال منه بمجرد أن يصبح النطاق قادرًا على الإرسال.
POST/domains/{id}/addresses
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
POST /domains/{id}/addresses
ينشئ عنوانًا على النطاق. يستقبل البريد بمجرد أن يستقبله النطاق، ويمكن الإرسال منه بمجرد أن يصبح النطاق قادرًا على الإرسال.
الطلب
المعاملات
localPartstringمطلوب- الجزء الذي يسبق `@`، من 1 إلى 64 حرفًا، بحروف صغيرة. و`*` هو طريقة كتابة catch-all ولا يمكن أن يكون عنوانًا مستقلًا.
labelstring | null- اسم للعنوان في التطبيق، بحد أقصى 120 حرفًا.
مثال
يتطلب domains:write. والمفتاح المقيَّد بعناوين أو نطاقات معيّنة يجب أن يملك النطاق كاملًا.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "localPart": "billing", "label": "Invoices" }'{ "object": "address", "id": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "address": "[email protected]", "localPart": "billing", "label": "Invoices", "enabled": true, "lastReceivedAt": null, "createdAt": "2026-09-25T10:00:00.000Z", "updatedAt": "2026-09-25T10:00:00.000Z"}إنشاء عنوان محذوف يعيده مفعّلًا. وإنشاء عنوان موجود بالفعل يعيد تفعيله ويعيده، ولا يغيّر تسميته إلا إذا أرسلت تسمية.
مع تفعيل catch-all، يبدأ العنوان الجديد بالتوقيع والإعدادات التي لدى catch-all.
العنوان المحجوز لحساب يجيب بـ 409 address_reserved، ومساحة العمل التي بلغت حدّ عناوينها تجيب بـ 422 workspace_limit_reached.
