domains

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

אימות

שלחו מפתח API כאסימון נושא (bearer token). על המפתח לכלול את הרשאה 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