ذخیرهٔ یک مخاطب
همان کاری را میکند که افزودن به مخاطبان و نگهداشتن در مخاطبان در برنامه میکنند، و نشانی در هر وضعیتی باشد امن است. نشانیای که هنوز مخاطب نیست مخاطب میشود و پاسخ `201` است. نشانی ثبتشده از یک ارسال `manual` میشود، و نشانی از پیش ذخیرهشده آنچه دارد نگه میدارد و پاسخ `200` است. نشانی حذفشده برمیگردد. بدنه اختیاری است.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
PUT /contacts/{email}
همان کاری را میکند که افزودن به مخاطبان و نگهداشتن در مخاطبان در برنامه میکنند، و نشانی در هر وضعیتی باشد امن است. نشانیای که هنوز مخاطب نیست مخاطب میشود و پاسخ 201 است. نشانی ثبتشده از یک ارسال manual میشود، و نشانی از پیش ذخیرهشده آنچه دارد نگه میدارد و پاسخ 200 است. نشانی حذفشده برمیگردد. بدنه اختیاری است.
نمونه
به contacts:write نیاز دارد. @ را URL-encode کنید.
curl -X PUT "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{ "name": "Grace Hopper"}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "photoUrl": null, "lastSeenAt": "2026-09-20T12:00:00.000Z", "createdAt": "2026-09-02T08:00:00.000Z", "updatedAt": "2026-09-23T10:15:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" } ]}name نام ذخیرهشده را جایگزین میکند و ندادنش آن را نگه میدارد. notes یادداشتهای ذخیرهشده را جایگزین میکند و null پاکشان میکند. هر کلید دیگری 422 unknown_parameter است.
برخلاف POST /contacts، نشانیای که از پیش در دفترچه است 409 نیست؛ برخلاف PATCH، نشانیای که در دفترچه نیست 404 نیست. مخاطب تازه به گروه پیشفرض میپیوندد.