Formularparameter für Suchanfragen

Die Parameter werden mit dem Zeichensatz UTF-8 kodiert.

Pflichtparameter

acc: Benutzername.
ids: Zu durchsuchende Website-IDs (mit ',' getrennt). Die Website-ID steht neben dem Namen der Website in der ersten Spalte der Übersicht im Verwaltungs-Interface.

Optionale Parameter

q: Suchabfrage. Bei fehlender oder leerer Suchabfrage gelten alle Dokumente als Treffer. Syntaxbeschreibung.
s: Nummer des ersten zu liefernden Treffers beginnend bei 1 (voreingestellt 1, maximal 500 minus Anzahl auszugebender Treffer).
c: Anzahl auszugebender Treffer (voreingestellt 10, maximal 500).
sort: Sortierung der Treffer. 'score' für beste Treffer zuerst, 'modified' für neueste Treffer zuerst (voreingestellt ist 'score').
nm: Ist dieser Parameter vorhanden, werden Suchworte im Suchergebnis nicht Fett markiert.

Zusatzbedingungen

Es können beliebig viele Zusatzbedingungen definiert werden, welche sich auf folgende Metadaten beziehen:

url: URL des Dokuments
content_type: Typ des Dokuments (Aus HTTP-Header 'Content-Type')
language: Sprache des Dokuments (Aus Meta-Tag 'language' bzw. 'content-language')
modified: Änderungszeitpunkt des Dokuments (Aus HTTP-Header bzw. Meta-Tag 'Last-Modified' oder Meta Tag 'date')
title: Titel des Dokuments
keywords: Meta-Tag 'keywords' aus HTML-Dokument
meta_*: Benutzerdefiniertes Meta-Tag (muß vorher im Verwaltungs-Interface unter 'Website ändern' definiert worden sein).

Eine Zusatzbedingung wird durch jeweils drei Parameter definiert:

f_1

Gibt an, auf welche der oben genannten Metadaten sich die Bedingung bezieht (z.B. 'modified').

op_1

Gibt an, wie verglichen werden soll (Vergleichsoperator). Folgende Werte sind möglich:

'=' (Ist gleich)
'!=' (Ist nicht gleich)
'<' (Kleiner)
'>' (Größer)
'<=' (Kleiner oder gleich)
'>=' (Größer oder gleich)
'like' (Wildcard/Jokersuche. '%' im Vergleichswert steht für beliebig viele Zeichen. '_' im Vergleichswert steht für genau ein Zeichen. '\%' oder '\_' im Vergleichswert sucht nach den Zeichen '%' oder '_'.)
'not like' (Siehe like)
'is null' (Wert konnte für entsprechende Seite nicht bestimmt werden. Zulässig für 'modified' und benutzerdefinierte Meta-Tags.)
'is not null' (Wert konnte für entsprechende Seite bestimmt werden. Zulässig für 'modified' und benutzerdefinierte Meta-Tags.)

val_1

Gibt den Vergleichswert an (irrelevant bei Operator 'is null')

Für mehr als eine Zusatzbedingung wird die Zahl am Ende der drei Parameter für jede neue Bedingung jeweils um 1 erhöht. Es werden nur Suchergebnisse geliefert, die alle Bedingungen zugleich erfüllen.

Beispiel1: Suche nach HTML-Seiten, welche seit dem 01.01.2008, 12 Uhr geändert wurden.

f_1: content_type
op_1: =
val_1: text/html

f_2: modified
op_2: >=
val_2: 2008-01-01 12:00:00

Beispiel2: Suche nach Dokumenten, welche 'suche' im Titel enthalten:


f_1: title
op_1: like
val_1: %suche%