domains

POST `/v1/domains/{domainId}/email-routing/addresses`

احراز هویت

یک کلید API را به عنوان یک توکن حامل ارسال کنید. این کلید باید دارای مجوز domains.dns.manage باشد؛ کلیدی که فاقد آن باشد با خطای 403 رد می‌شود، نه 404.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

curl -X POST https://api.zinndigital.com/v1/domains/{domainId}/email-routing/addresses \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "email": <string> }'

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید

جزئیات

**This sends mail to a third party.** The provider emails the address a verification link and will not deliver anything to it until the recipient clicks, so the response carries `verified: false` rather than pretending the destination is usable. Destination addresses are **account-scoped** at the provider, not zone-scoped: one address book serves every domain on the account. Requires `domains.dns.manage`.

پارامترها

نام	نوع	الزامی	چیست
`domainId (path)`	`Uuid`	بله	The domain's id.

بدنه درخواست

نام	نوع	الزامی	چیست
`email`	`string`	بله	The provider emails this address a verification link. It is a write that reaches a third party, so it is permissioned and audit-logged accordingly.

پاسخ

نام	نوع	الزامی	چیست
`address_id`	`string`	بله	—
`email`	`string`	بله	—
`verified`	`boolean`	بله	A fact about the recipient's action, never ours: the provider emails a verification link and will not deliver until it is clicked.
`created`	`string`	بله	—

خطاهایی که این نقطه پایانی می‌تواند برگرداند

401 · 403 · 404 · 422 · 429 · 503

POST /v1/domains/{domainId}/email-routing/addresses