Bir adresi yönlendirme
Bir adresin postasının, posta kutusu dışında nereye gittiği. Her hedef, bir şey almadan önce e-postayla onay verir.
5 çağrıdan herhangi birini çalışma alanınızda çalıştırır.
GET /domains/{id}/addresses/{addressId}/forwards
Bir adresin postasının, posta kutusu dışında nereye gittiği. Her hedef, bir şey almadan önce e-postayla onay verir.
Hedefleri listeleme
domains:read gerektirir. Adresin her hedefi, en eskisi önce. destination, adresin burada da bir kopya tutup tutmadığını (mailbox) ya da yalnızca yönlendirme yapıp yapmadığını (forward) söyler; max ise bir adresin en fazla kaç hedefi olabileceğidir.
curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards" -H "$AUTH"{ "object": "list", "address": "[email protected]", "destination": "mailbox", "max": 10, "data": [ { "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "enabled": true, "status": "live", "confirmedAt": "2026-09-26T08:12:40.000Z", "askedAt": "2026-09-26T08:02:11.000Z", "lastRelayAt": "2026-09-30T16:45:03.000Z", "lastError": null, "failures": 0, "createdAt": "2026-09-26T08:02:11.000Z" } ]}status, hedef postayı istediğini onayladığında live, yanıt vermediği sürece pending, hayır dediğinde refused ve kapalı olduğu sürece paused olur. Yalnızca live bir hedef bir şey alır.
Hedef ekleme
domains:write gerektirir. { emails } ile POST /domains/{id}/addresses/{addressId}/forwards, 1 ile 10 arası adres. Her yeni hedefe onay isteyen bir e-posta gönderilir, bu yüzden hedef pending olarak başlar.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "emails": ["[email protected]", "[email protected]"] }'{ "object": "address_forwards", "added": [ { "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "enabled": true, "status": "pending", "confirmedAt": null, "askedAt": "2026-09-26T08:02:11.000Z", "lastRelayAt": null, "lastError": null, "failures": 0, "createdAt": "2026-09-26T08:02:11.000Z" } ], "skipped": [ { "email": "[email protected]", "reason": "[email protected] is hosted here, so it cannot be a forwarding destination. Share the address with that person instead." } ]}Burada barındırılan bir adres, listede zaten olan bir adres, döngü oluşturacak bir adres, 10 sınırını aşan bir adres ve bu çalışma alanından gelen postayı reddetmiş bir adres nedeniyle birlikte skipped içinde belirtilir; geri kalanlar yine de eklenir.
Kapalı bir adres 409 address_disabled ile reddedilir.
Belirli adreslerle ya da alan adlarıyla sınırlı bir anahtarın alan adının tamamına sahip olması gerekir; bir üye adına çalışan bir uygulama ise yalnızca o üyenin erişebildiği bir adresi yönlendirebilir.
Bir OAuth erişim tokenı bu çağrı için bir doğrulama kodu gerektirir. Uygulama son 60 dakika içinde bir kod doğrulayana kadar çağrı 403 step_up_required yanıtını verir ve hiçbir şeyi değiştirmez. Bir API anahtarından asla istenmez. Kimlik doğrulama sayfası bir kodun nasıl isteneceğini ve doğrulanacağını gösterir.
Bir hedefi duraklatma ya da açma
domains:write gerektirir. { enabled } ile PATCH /domains/{id}/addresses/{addressId}/forwards/{forwardId}. Duraklatılmış bir hedef onayını korur, bu yüzden yeniden açmak için onay gerekmez.
curl -X PATCH "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards/9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "enabled": false }'{ "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "enabled": false, "status": "paused", "destination": "mailbox"}Açık olan son hedef duraklatıldığında adres postasını yeniden burada tutmaya başlar ve destination bunu belirtir.
Bir OAuth erişim tokenı bu çağrı için bir doğrulama kodu gerektirir. Uygulama son 60 dakika içinde bir kod doğrulayana kadar çağrı 403 step_up_required yanıtını verir ve hiçbir şeyi değiştirmez. Bir API anahtarından asla istenmez. Kimlik doğrulama sayfası bir kodun nasıl isteneceğini ve doğrulanacağını gösterir.
Bir hedefi kaldırma
domains:write gerektirir. DELETE /domains/{id}/addresses/{addressId}/forwards/{forwardId}. Ona artık hiçbir şey yönlendirilmez.
curl -X DELETE "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards/9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d" -H "$AUTH"{ "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "deleted": true, "destination": "mailbox"}Açık olan son hedef buysa, adres postasını yeniden burada tutmaya başlar.
Bir OAuth erişim tokenı bu çağrı için bir doğrulama kodu gerektirir. Uygulama son 60 dakika içinde bir kod doğrulayana kadar çağrı 403 step_up_required yanıtını verir ve hiçbir şeyi değiştirmez. Bir API anahtarından asla istenmez. Kimlik doğrulama sayfası bir kodun nasıl isteneceğini ve doğrulanacağını gösterir.
Bir hedeften yeniden onay isteme
domains:write gerektirir. POST /domains/{id}/addresses/{addressId}/forwards/{forwardId}/resend onay e-postasını bir kez daha gönderir.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards/9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d/resend" -H "$AUTH"{ "object": "address_forward_consent", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "status": "sent"}status değeri sent, hedefin hiçbir şeye ihtiyacı yoksa already-confirmed, son e-posta az önce gittiyse too-soon, hedef bu çalışma alanından gelen postayı reddettiyse revoked ya da e-posta gönderilemediyse send-failed olur.
Bir OAuth erişim tokenı bu çağrı için bir doğrulama kodu gerektirir. Uygulama son 60 dakika içinde bir kod doğrulayana kadar çağrı 403 step_up_required yanıtını verir ve hiçbir şeyi değiştirmez. Bir API anahtarından asla istenmez. Kimlik doğrulama sayfası bir kodun nasıl isteneceğini ve doğrulanacağını gösterir.
Referans
/domains/{id}/addresses/{addressId}/forwardsTam başvuru/domains/{id}/addresses/{addressId}/forwardsTam başvuru/domains/{id}/addresses/{addressId}/forwards/{forwardId}Tam başvuru/domains/{id}/addresses/{addressId}/forwards/{forwardId}Tam başvuru/domains/{id}/addresses/{addressId}/forwards/{forwardId}/resendTam başvuru