rest_api
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
| rest_api [2020/02/19 17:00] – lwsystems | rest_api [2025/06/26 14:03] (aktuell) – [Suchanfrage nach einer Message-ID] lwsystems | ||
|---|---|---|---|
| Zeile 119: | Zeile 119: | ||
| ==== Suche in einem Zeitraum | ==== Suche in einem Zeitraum | ||
| - | < | + | < |
| Hier werden die E-Mails im Zeitraum zwischen 23.08.2013 10:20 und dem 27.08.2013 um 16:05 gesucht. | Hier werden die E-Mails im Zeitraum zwischen 23.08.2013 10:20 und dem 27.08.2013 um 16:05 gesucht. | ||
| - | // | ||
| - | * '' | ||
| - | * '' | ||
| ==== Suchanfrage mit Filterung | ==== Suchanfrage mit Filterung | ||
| Zeile 140: | Zeile 137: | ||
| In dieser Suchanfrage werden alle E-Mails im Standard-Container gesucht, die von Absenderadressen stammen, in denen das Literal „hansen-und-meyer“ vorkommt ODER deren Empfängeradressen das Literal „vertrieb@“ enthalten. | In dieser Suchanfrage werden alle E-Mails im Standard-Container gesucht, die von Absenderadressen stammen, in denen das Literal „hansen-und-meyer“ vorkommt ODER deren Empfängeradressen das Literal „vertrieb@“ enthalten. | ||
| + | |||
| + | ==== Suche nach Header Message-ID | ||
| + | |||
| + | < | ||
| + | |||
| + | In dieser Suchanfrage wird nach der E-Mail mit dem Header // | ||
| ===== Suchkriterien | ===== Suchkriterien | ||
| Zeile 153: | Zeile 156: | ||
| Der API-Call zum Zugriff auf eine archivierte E-Mail dient dazu, eine E-Mail (incl. etwaiger Attachements) aus dem Archiv zu holen. Da jede E-Mail im Archiv eindeutig identifiziert ist, erfolgt der Zugriff über diesen eindeutigen Identifyer. | Der API-Call zum Zugriff auf eine archivierte E-Mail dient dazu, eine E-Mail (incl. etwaiger Attachements) aus dem Archiv zu holen. Da jede E-Mail im Archiv eindeutig identifiziert ist, erfolgt der Zugriff über diesen eindeutigen Identifyer. | ||
| - | ===== Syntaxbeispiel für den Abruf einer E-Mail aus dem Archiv | + | ===== Abruf einer E-Mail aus dem Archiv |
| Hinweis: Die URLs werden aus drucktechnischen Gründen teilweise mehrzeilig dargestellt. Sie sind jedoch ohne Leerzeichen usw. in einer Zeile anzugeben! | Hinweis: Die URLs werden aus drucktechnischen Gründen teilweise mehrzeilig dargestellt. Sie sind jedoch ohne Leerzeichen usw. in einer Zeile anzugeben! | ||
| Zeile 174: | Zeile 177: | ||
| Die aus dem Archiv gelesene E-Mail wird standardmäßig als JSON Objekt an das aufrufende Programm zurückgegeben. Mittels der Option format kann die Rückgabe der E-Mail im „raw“ Format, also RFC 822 bzw. RFC 2822 (Plaintext) erzwungen werden. | Die aus dem Archiv gelesene E-Mail wird standardmäßig als JSON Objekt an das aufrufende Programm zurückgegeben. Mittels der Option format kann die Rückgabe der E-Mail im „raw“ Format, also RFC 822 bzw. RFC 2822 (Plaintext) erzwungen werden. | ||
| - | *format: „raw“, wenn die Mail im RFC-822 Format | + | * format=raw - E-Mail im RFC-822 Format |
| + | * skipUTF8Recode=true - E-Mail im Orginal zurück geben | ||
| + | * header=true - Secret Header zurück geben | ||
| + | **Achtung!** Um eine E-Mail aus dem Repo zum Re-Indexieren ist es erforderlich, | ||
| ===== Rückgabewerte eines Abrufs einer E-Mail aus dem Archiv | ===== Rückgabewerte eines Abrufs einer E-Mail aus dem Archiv | ||
| ==== Resultatwerte (HTTP-Fehlercodes der Suchoperation): | ==== Resultatwerte (HTTP-Fehlercodes der Suchoperation): | ||
| Zeile 186: | Zeile 192: | ||
| - | ===== Syntaxbeispiel für den Abruf eines Attachments einer E-Mail im Archiv | + | ===== Abruf eines Attachments einer E-Mail im Archiv |
| Ein Attachment kann über den Dateinamen oder über die Attachment-Id referenziert werden. | Ein Attachment kann über den Dateinamen oder über die Attachment-Id referenziert werden. | ||
rest_api.1582131656.txt.gz · Zuletzt geändert: 2020/02/19 17:00 von lwsystems
Seiten-Werkzeuge
