E-Mails empfangen: Lesen
Suchen
Durchsuchen Sie das Postfach nach Absender, Domain, Betreff, Inhalt oder Label, mit denselben Operatoren wie das Suchfeld im Webmail.
https://g.sendcorex.com/v1command: searchOhne field ist die Suche automatisch: Eine vollständige E-Mail-Adresse sucht nach dem exakten Absender, domain.com sucht nach Domain, und alles andere durchsucht Betreff, Inhalt und Absendername.
Mit Operatoren (from:, is:unread…) werden die Ergebnisse nach Konversation gruppiert: eine Zeile pro Thread, mit der neuesten passenden Nachricht. Ohne in: sind Spam und Papierkorb ausgeschlossen.
Argumente
querystringerforderlichWonach gesucht wird, bis zu 256 Zeichen. Bei mehreren Wörtern kommt das erste aus dem Index, die übrigen filtern nach Betreff und Vorschau.
fieldstringoptionalBeschränkt eine einfache Suche auf
from,to,subject,body,senderoderlabel. Wird ignoriert, wenn die Abfrage Operatoren enthält.limitnumberoptionalSeitengröße, 1 bis 100. Standard ist 25.
cursorstringoptionalDer
next_cursorder vorherigen Seite.
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "search",
args: {
query: "ana@client.com",
field: "from",
limit: 5
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "search",
"id": "0",
"type": "SUCCESS",
"data": {
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"folders": [
"INBOX"
],
"is_read": false,
"is_starred": false,
"is_important": false,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}
}
]
}Antwortfelder
messages[]Passende Nachrichten, neueste zuerst. Jede hat
message_uid,thread_id,subject,preview,from_name,from_email,folders, die Flags gelesen/Stern/wichtig undreceived_at.has_more / next_cursorPaginierung.
Operatoren
Kombinieren Sie sie mit einfachen Wörtern. Ein Wert mit Leerzeichen gehört in Anführungszeichen: subject:"new proposal". Setzen Sie - davor, um auszuschließen: -from:noreply, -newsletter.
Request-Body
{
"commands": [
{
"command": "search",
"args": {
"query": "from:ana@client.com has:attachment newer_than:30d invoice"
}
}
]
}from: / to:Absender / Empfänger (to oder cc), Teil des Namens oder der Adresse.
subject: / label:Betrefftext / ein Label.
in:inbox,sent,archive,trash,spam,drafts,promotions,snoozed,scheduled,agents,not-subscribingoder die ID eines eigenen Ordners.has:attachmentNur Nachrichten mit Anhängen.
is:unread / is:read / is:starred / is:importantStatus der Nachricht.
after: / before:Ein Datum
YYYY/MM/DD(oderYYYY-MM-DD), UTC.newer_than: / older_than:7d,2w,3m(30 Tage) oder1y.
Nur Filter ohne Suchwort (is:unread in:archive) liefern threads (die Konversationsliste dieses Ordners) statt messages.
Suchbeispiele
Request-Bodys
// subject + body + sender name
{
"commands": [
{
"command": "search",
"args": {
"query": "invoice september"
}
}
]
}
// exact sender
{
"commands": [
{
"command": "search",
"args": {
"query": "ana@client.com",
"field": "from"
}
}
]
}
// everyone from a domain
{
"commands": [
{
"command": "search",
"args": {
"query": "client.com"
}
}
]
}
// messages with a label
{
"commands": [
{
"command": "search",
"args": {
"query": "cliente-vip",
"field": "label"
}
}
]
}Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
TOKEN_EXPIREDDer Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.
- 401
INVALID_TOKENDer Token ist fehlerhaft, unbekannt oder widerrufen.
- 429
RATE_LIMITEDMehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.
- CMD
INVALID_ARGSEin erforderliches Argument fehlt oder ist ungültig.
- CMD
INVALID_CURSORDer Cursor ist fehlerhaft oder gehört zu einem anderen Konto oder Ordner.
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.