CdE-Kurier Spezifikation

1.1   Schlüsselworte

ID: <Message-ID>

verpflichtend oder implizit als Message-ID: im news-Header

Eindeutige ID.

Wird normalerweise nicht angegeben, sondern aus der Message-ID der news-Message extrahiert.

TYPE: BIETE|SUCHE|CANCEL

optional, default: BIETE

mögliche Werte: BIETE, SUCHE, CANCEL

Bestimmt, welche weiteren Schlüsselworte vorkommen müssen/dürfen.

AUTH: <Token>

optional

Kann verwendet werden, um irgendeine Art der Authentifizierung mitzuspeichern, um im Fehlerfall bzw. bei unsachgemäßer Verwendung die Quelle der Nachricht nachvollziehen zu können.

Das Token kann dabei z.B. eine E-Mail-Adresse, eine IP-Adresse (z.B. bei einem Webformular) oder ein Login-Name sein.

Anlegen eines Eintrags (TYPE: BIETE bzw. TYPE: SUCHE):

PICKUP-DATE: YYYY-MM-DD HH:MM

verpflichtend, HH:MM ist optional

bei BIETE: Spätestmöglicher Zeitpunkt, zu dem etwas zu transportierendes noch mitgenommen werden kann.

bei SUCHE: Frühestmöglicher Zeitpunkt, zu dem etwas zu transportierendes schon abgeliefert werden kann.

PICKUP-PLACE: <Text>:

verpflichtend

Menschenverständliche Erklärung, wo die Reise beginnt.

DROPOFF-DATE: YYYY-MM-DD HH:MM

verpflichtend, HH:MM ist optional

bei BIETE: Frühestmöglicher Zeitpunkt, zu dem der transportierende Gegendstand weiter gegeben werden kann.

bei SUCHE: Spätestmöglicher Zeitpunkt, zu dem der transportierende Gegendstand weiter gegeben sein muss.

DROPOFF-PLACE: <Text>

verpflichtend

Menschenverständliche Erklärung, wo die Reise endet.

CONTACT: <Text>

verpflichtend

Eine Möglichkeit, die Person zu kontaktieren, die etwas mitnehmen kann (BIETE) bzw. die eine Mitnahmemöglichkeit sucht (SUCHE).

Steht die Person in der CdE-Datenbank, genügt der Name. Andernfalls sollte eine gültige E-Mail-Adresse oder eine gültige Telefonnummer angegeben werden.

PICKUP|DROPOFF-POSTCODE: cc <PLZ>

optional

Postleitzahl des Start-/Zielorts.

cc = country code (wie bei den DNS Toplevel Domains)

<PLZ> = Postleitzahl nach den Gepflogenheiten des jeweiligen Landes.

Beispiel: uk SA2 8PP

PICKUP|DROPOFF-EVENT: xxYYYY-n

optional

Gibt an, dass Beginn/Ende der Reise eine entsprechende CdE-Veranstaltung ist.

xx = Kürzel der Veranstaltung

wa: WinterAkademie

pa: PfingstAkademie

sa: SommerAkademie

ma: Multinationale Akademie

jgw: JGW-Akademie

weitere Kürzel werden evtl. in Zukunft definiert

YYYY = Jahr der Veranstaltung

-n = laufende Nummer (chronologisch) unter allen Veranstaltungen, die in den ersten zwei Merkmalen uebereinstimmen. Falls weggelassen: -1

ROUTE: <Text>

optional

Informationen zur Route, damit evtl. auch unterwegs Gegenstände mitgenommen/weitergegeben werden können.

COMMENT: <Text>

optional

Menschenlesbarer Kommentar, Einschränkungen etc.

Streichen eines Eintrags (TYPE: CANCEL):

Falls ein Eintrag nicht mehr stimmt, man doch kein Gepäck mehr mitnehmen kann oder schon jemand gefunden wurde, der das Gepäck mitnimmt, sollte der Eintrag gestrichen werden.

Für Einträge, die nur deshalb nicht mehr relevant sind, weil DROPOFF-DATE schon vorbei ist, sollen keine CANCEL-Meldungen verschickt werden.

CANCEL-ID: <ID des zu streichenden Eintrags>

verpflichtend oder implizit als In-Reply-To: im news-Header

Gibt die ID des Eintrags an, der gestrichen werden soll.

COMMENT: <Text>

optional

Menschenlesbarer Kommentar.

Sonst keine weiteren Zeilen.

Weitere Schlüsselworte können später eingeführt werden; es sollen also keine Annahmen gemacht werden, dass ein bestimmtes Schlüsselwort ungenutzt ist. Allerdings wird zugesichert, dass nie Schlüsselworte, die mit X- anfangen, ins offizielle Protokoll aufgenommen werden.