getSimilarEmails: төстэй и-мэйлүүдийг авах API арга

Энэ аргаар өгөгдсөн и-мэйлтэй төстэй, мөн тухайн компанийн хүрээнд хамаарах и-мэйлүүдийг авна.

Параметрүүд

• emailId — төстэй и-мэйлүүдийг тодорхойлоход ашиглах жишиг и-мэйлийн гадаад (external) ID; хүсэлтэд заавал орно; төрөл: String. Утга нь хоосон мөр эсвэл "0" байж болохгүй. Жишээ: "emailId": "AAMkAGFiOTUwZGQwLTA2M2EtNDdmMS05OTkzLWUzZWU2ODFiNjFiZQBGAAAAAACDOImdWGluQ7r9pFUliEgGBwCEBm6gCuzWSYeoOcRa3_5rAAAAAAEPAACEBm6gCuzWSYeoOcRa3_5rAAPFIK-oAAA="

> Тэмдэглэл: Энэ аргын буцаасан хариунд гадаад и-мэйл ID нь илэрсэн и-мэйл бүрийн mailId гэж харагдана.

Бүх public API аргад нийтлэг параметрүүд

• id — хүсэлтийг хариутай нь холбох таниулагч. Хүлээн авагч хариунд ижил утгыг буцаадаг тул дуудлагыг амархан мөрдөнө; хүсэлтэд заавал орно; төрөл: String; нэмэлт шаардлага байхгүй. Жишээ: "id": "ad12cb61-52b3-4209-a87a-93a8530d91cb"
• method — хүсэлт илгээж буй аргын нэр; хүсэлтэд заавал орно; төрөл: String; зөв аргын нэр байх ёстой. Жишээ: "method": "methodName"
• jsonrpc — хүсэлт ба хариуд хэрэглэх JSON-RPC-ийн хувилбар; хүсэлтэд заавал орно; төрөл: String; цорын ганц боломжит утга нь 2.0. Жишээ: "jsonrpc": "2.0"
• params — хүсэлтийн тохиргоог агуулсан объект; хүсэлтэд заавал орно; төрөл: Object; нэмэлт шаардлага байхгүй. Жишээ: "params": {...}

params объектын дотор:

• page — үр дүнгийн хуудасны дугаар; заавал биш; төрөл: Integer; үндсэн утга: 1. Жишээ: "page": 2
• perPage — нэг хуудсанд харуулах үр дүнгийн тоо; заавал биш; төрөл: Integer; дээд хязгаар нь нэг хуудсанд 1000 зүйл; үндсэн утга: 1000. Жишээ: "perPage": 1

Буцаах утга

• result — Object; хүсэлт амжилттай эсэх, олдсон төстэй и-мэйлийн нийт тоо болон тэдгээр и-мэйлийн дэлгэрэнгүй жагсаалтыг агуулна. Доорх result хэсгийг үзнэ үү.

Объектууд

result

• success — Boolean; үйлдэл амжилттай бол true, үгүй бол false буцаана.
• emails — Array of Objects; объект бүр дараах тохиргоог агуулна:

- _id (24 тэмдэгтийн арван зургаатын String) - GravityZone Control Center дахь node-той холбогдох и-мэйлийн ID.
- companyId (String) - и-мэйл хүлээн авсан компанийн ID.
- similarityHash (String) - и-мэйлийг тодорхойлоход ашигласан төстэй байдлын хэш.
- subject (String) - и-мэйлийн гарчиг.
- to (Array of Strings) - и-мэйл хүлээн авагчдын жагсаалт.
- from (String) - илгээгчийн и-мэйл.
- mailId (String) - гадаад и-мэйл ID.
- userId (String) - хүлээн авагчийн гадаад дансны таниулагч.
- type (Integer) - дэмжигдсэн цорын ганц type утга нь 1 бөгөөд Microsoft 365 (Office 365) и-мэйлийг илэрхийлнэ.
- receivedTime (String) - и-мэйл хүлээн авсан огноо, цаг.
- outgoing (Boolean) - и-мэйлийг таны компанийн хэн нэгэн илгээсэн бол true; таны компанийн хэн нэгэн хүлээн авсан бол false.
> Тэмдэглэл: Жишиг и-мэйл нь буцаасан и-мэйлийн жагсаалтад багтана.

• total — Integer; олдсон төстэй и-мэйлийн нийт тоо.

Жишээ

Хүсэлт

{
    "params": {
        "emailId": "AAMkAGFiOTUwZGQwLTA2M2EtNDdmMS05OTkzLWUzZWU2ODFiNjFiZQBGAAAAAACDOImdWGluQ7r9pFUliEgGBwCEBm6gCuzWSYeoOcRa3_5rAAAAAAEPAACEBm6gCuzWSYeoOcRa3_5rAAPFIK-oAAA=",
        "perPage": 1,
        "page": 1
    },
    "jsonrpc": "2.0",
    "method": "getSimilarEmails",
    "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

Хариу

{
    "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8",
    "jsonrpc": "2.0",
    "result": {
        "success": true,
        "emails": [
            {
                "_id": "6909ca075c65b7584a65deb3",
                "companyId": "6837077785c907e4ca044812",
                "similarityHash": "hash",
                "subject": "Test Email 2 - 2025-11-04T09:40:22.441Z",
                "to": ["user@bitdefender.onmicrosoft.com"],
                "from": "sender@bitdefender.onmicrosoft.com",
                "mailId": "BBNDAhkNTIyNjYzLTQ1ZmYtNDZlNi1iMjExLWVmZjhlYWRjYzIxNABGAAAAAAB7fiYJE372QbIC-lf_MXEHBwAJPJXoGMjpRYZoFcE4nZMWAAAAAAEPAAAJPJXoGMjpRYZoFcE4nZMWAAPF9SdyAAA=",
                "userId": "d0c55688-45c4-4bfc-a033-c49caa3b3b9e",
                "type": 1,
                "receivedTime": "2025-09-15T11:44:33",
                "outgoing": true
            }
        ],
        "total": 18
    }
}