فرستندگان
هر عملیات در این گروه: آنچه می‌پذیرد، آنچه برمی‌گرداند و خطاهایی که ممکن است با آن‌ها پاسخ دهد.
عملیات‌ها
What is known about the organisation behind a sender: the line the reading pane shows under an unfamiliar sender, kept per domain for the whole workspace.
GET/senders/{email}
Read what is known about a sender
A sentence or two about the organisation behind the domain of the address, once it has been looked up. A domain nobody has looked up yet is a 404: POST /senders/{email}/research looks it up.
Requires the threads:read scope.
پارامترهای مسیر
emailstringالزامیAn address of the sender, such as
[email protected]. Only its domain is read.
خروجی
What is known about the sender.
خطاها
خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها
همچنین در دسترس در
POST/senders/{email}/research
Look a sender up
Searches the web for the organisation behind the domain of the address and keeps what it found for the whole workspace, as the reading pane does the first time it shows a sender. A domain that was looked up before is answered from what was kept, and nothing is searched again. Only the owner of the workspace may look senders up, with a key or an app that is not limited to particular addresses or domains, and a workspace looks up at most 200 a day.
Requires the threads:read scope.
پارامترهای مسیر
emailstringالزامیAn address of the sender, such as
[email protected]. Only its domain is read.
خروجی
What was found.
خطاها
- 404
Nothing could be found about the domain.
- 409
ai_not_configured: looking senders up is not available on this server.- 429
research_limit_reached: the workspace has looked up 200 senders today.
خطاهایی که هر عملیاتی ممکن است برگرداند400401403422500فهرست خطاها
همچنین در دسترس در
اشیا
SenderProfileobject
objectstringالزامی- یکی از
"sender_profile" domainstringالزامیThe domain that was looked up.
aboutstringالزامیA sentence or two in plain prose about the organisation behind it.
تا 400 نویسهupdatedAtstringالزامی- قالب
date-time