EinloggenMenü
API

APIbeta

e-nautia bietet Ihnen jetzt eine öffentliche REST-API. Die Basis-URL für alle Anrufe: https://api.e-nautia.com
Da es eine Beta-Version ist, kann sich die API jeder Zeit weiterentwickeln. Abonnieren Sie unseren Newsletter um informiert zu bleiben.

Zugriffe werden durch DIE POST HTTP- Methode gemacht, durch die Verwendung der "token"- Parameter, die nach der ersten Authentifizierung erhalten werden. Alle API-Aufrufe bringen einen HTTP-Code 200 ohne Beständigkeit, mit einem JSON- Objekt. Zeichen sind mit UTF-8 codiert.

Wenn Daten geändert werden, wird dies im UTC YYYY-MM-DD HH:mm:ss Format über eine "modification"-Variable” datiert.

Das Entfernen der Daten erfolgt in zwei Phasen. Eine zugehörige "del"-Variable steht auf 1, wenn die Zeile gelöscht wurde und auf 0, wenn die Zeile weiterhin besteht. Um eine Zeile zu löschen, muss die "del"-Variable auf 1 stehen. Der e-nautia Server löscht die Daten vollständig nach einem Monat.

Authentifizierung

Identifizierung

URI: /login

Zu sendende Daten:

Name Typ Beschreibung
login Kette Kennung oder die E-Mail-Adresse des Benutzers
password Kette Passwort des Benutzers
lang Kette Zu verwendende Sprache. Mögliche Werte:
de: Deutsche
en: Englisch
es: Spanisch
fr: Französisch
it: Italienisch
ja: Japanisch
nl: Niederländisch
pt: Portugiesisch
ru: Russisch

Antwort, wenn die Authentifizierung fehlgeschlagen ist:

{
"access_token":"ZkcqmSWsKnMSXq5hPpWd",
"expires_in":3600,
"token_type":"Bearer"
}
Variable Beschreibung
access_token Wert, der von der Anwendung gespeichert und wiederverwendet werden soll
expires_in Dauer in Sekunden, während der die API mit Hilfe des access_token genutzt werden kann
Nachstehend muss eine neue Authentifizierung vorgenommen werden.
token_type Methode der Generierung der access_token

Antwort, wenn die Authentifizierung fehlgeschlagen ist:

{
"errorCode":2,
"errorMessage":"Das Kennwort ist falsch."
}
Variable Beschreibung
errorCode Fehler Code
errorMessage Fehlermeldung

Reaktion im Fall einer ungültigen Verwendung eines access_token:

{
"statusCode":401,
"statusMessage":"invalid token"
}

Eine neue Authentifizierung muss dann vorgenommen werden.

Die Namen der Server E-Mail und FTP

URI: /server

Beispiel für eine Antwort:

{
"login":"georges",
"name":"Georges Der Yeti",
"ftpserver":"e2.e-nautia.com",
"imapserver":"mail.e-nautia.com",
"popserver":"mail.e-nautia.com",
"smtpserver":"mail.e-nautia.com",
"mail":"contact@e-nautia.com"
}
Variable Beschreibung
login Kennung
name Vollständiger Name
ftpserver Name des FTP-Servers (Nur angegeben, wenn der Zugriff autorisiert ist)
imapserver Name des IMAP-Servers (Nur angegeben, wenn der Zugriff autorisiert ist)
popserver Name des POP-Servers (Nur angegeben, wenn der Zugriff autorisiert ist)
smtpserver Name des SMTP-Servers (Nur angegeben, wenn der Zugriff autorisiert ist)
mail E-Mail-Adresse (Nur angegeben, wenn der Zugriff autorisiert ist)

Kontakte

Abrufen von Kontakten

URI: /contacts

Beispiel für eine Antwort:

[
{"id":111,
"g":{"value":770,"modification":"2015-01-01 00:00:00"},
"email":{"value":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
"fullname":{"value":"Georges Der Yeti","modification":"2015-01-01 00:00:00"},
"firstname":{"value":"Georges","modification":"2015-01-01 00:00:00"},
"lastname":{"value":"Der Yeti","modification":"2015-01-01 00:00:00"},
"homecity":{"value":"Strasbourg","modification":"2015-01-01 00:00:00"}
},
{"id":112,
"g":{"value":770,"modification":"2015-01-01 00:00:00"},
"email":{"value":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
"fullname":{"value":"Big Foot","modification":"2015-01-01 00:00:00"},
"firstname":{"value":"Big","modification":"2015-01-01 00:00:00"},
"lastname":{"value":"Foot","modification":"2015-01-01 00:00:00"},
"homecity":{"value":"Le Havre","modification":"2015-01-01 00:00:00"}
}
]

Alle Variablen mit einem aufgezeichneten Datum wurden zurückgesendet.

Allgemeine Daten:

Variable Beschreibung
id Einzigartige Kennung des Kontakts
value Aufgezeichneter Wert
modification Datum, an dem die zugehörigen Daten zuletzt geändert wurden

Veränderbare Daten:

Name Typ Beschreibung
g Ganzzahl Kennung der Kontaktgruppe
mail Kette E-Mail-Adresse
firstname Kette Vorname
lastname Kette Nachname
organization Kette Name der Organisation
fullname Kette Vollständiger Name
mobilephone Kette Mobiltelefonnummer
homestreet Kette Persönliche Anschrift
homecity Kette Persönliche Wohn- Stadt
homepostalcode Kette Persönliche Wohn- Postleitzahl
homefax Kette Persönliche Wohn- Faxnummer
homephone Kette Persönliche Wohn- Festnetz Telefonnummer
birthday date Geburtsdatum
notes Kette Vermerk
webpage Kette Webseite
del Ganzzahl 0, um den Kontakt wieder herzustellen
1, um den Kontakt zu löschen

Einen Kontakt hinzufügen

URI: /contacts/add

Beispiel für eine Antwort:

{
"id":111,
{"g":770,"gname":"Freunde","modification":"2015-01-01 00:00:00"},
{"email":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
{"fullname":"Georges Der Yeti","modification":"2015-01-01 00:00:00"},
{"firstname":"Georges","modification":"2015-01-01 00:00:00"},
{"lastname":"Der Yeti","modification":"2015-01-01 00:00:00"},
{"homecity":"Strasbourg","modification":"2015-01-01 00:00:00"}
}

Kontaktdaten werden mit dem Datum der letzten Änderung versehen.

Ändern eines Kontakts

URI: /contacts/edit/{id}
({id} mit dem entsprechenden Wert ersetzen)

Beispiel für eine Antwort:

{
"id":111,
{"g":770,"gname":"Freunde","modification":"2015-01-01 00:00:00"},
{"email":"contact@e-nautia.com","modification":"2015-01-01 00:00:00"},
{"fullname":"Georges Der Yeti","modification":"2015-01-01 00:00:00"},
{"firstname":"Georges","modification":"2015-01-01 00:00:00"},
{"lastname":"Der Yeti","modification":"2015-01-01 00:00:00"},
{"homecity":"Strasbourg","modification":"2015-01-01 00:00:00"}
{"del":1,"modification":"2015-01-01 00:00:00"}
}

Kontaktdaten werden mit dem Datum der letzten Änderung versehen.

Kontakt Kategorien

Abrufen Kontakt Kategorien

URI: /contacts/groups

Beispiel für eine Antwort:

[
{"id":770,
"name":{"value":"Freunde","modification":"2015-01-01 00:00:00"},
}
{"id":771,
"name":{"value":"Aufgabe","modification":"2015-01-01 00:00:00"}
}
]

Alle Variablen mit einem aufgezeichneten Datum wurden zurückgesendet.

Allgemeine Daten:

Variable Beschreibung
id Einzigartige Kennung des Kontakts
value Aufgezeichneter Wert
modification Datum, an dem die zugehörigen Daten zuletzt geändert wurden

Veränderbare Daten:

Name Typ Beschreibung
name Kette Name der Kategorie
del Ganzzahl 0, um die Kategorie wieder herzustellen
1, um die Kategorie zu löschen

Eine Kontaktkategorie Hinzufügen

URI: /contacts/groups/add

Beispiel für eine Antwort:

{
"id":770,
{"name":"Freunde","modification":"2015-01-01 00:00:00"}
}

Kategoriedaten werden mit dem Datum der letzten Änderung versehen.

Ändern einer Kontaktkategorie

URI: /contacts/groups/edit/{id}
({id} mit dem entsprechenden Wert ersetzen)

Beispiel für eine Antwort:

{
"id":770,
{"name":"Freunde","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Kategoriedaten werden mit dem Datum der letzten Änderung versehen.

Notizen

Notizen Abrufen

URI: /notes

Beispiel für eine Antwort:

[
{"id":11,
"title":{"value":"Aufgaben zu erledigen","modification":"2015-01-01 00:00:00"},
"note":{"value":"Reinigung","modification":"2015-01-01 00:00:00"},
"del":{"value":0,"modification":"2015-01-01 00:00:00"}
},
{"id":12,
"title":{"value":"Shopping","modification":"2015-01-01 00:00:00"},
"note":{"value":"Kartoffeln und vieles mehr","modification":"2015-01-01 00:00:00"},
"del":{"value":1,"modification":"2015-01-01 00:00:00"}
}
]

Alle Variablen mit einem aufgezeichneten Datum wurden zurückgesendet.

Allgemeine Daten:

Variable Beschreibung
id Eindeutige Kennung der Notiz
value Aufgezeichneter Wert
modification Datum, an dem die zugehörigen Daten zuletzt geändert wurden

Veränderbare Daten:

Name Typ Beschreibung
title Kette Titel
note Text Inhalt der Notiz
del Ganzzahl 0, um die Notiz wieder herzustellen
1, um die Notiz zu löschen

Hinzufügen einer Notiz

URI: /notes/add

Beispiel für eine Antwort:

{
"id":11,
{"title":"Aufgaben zu erledigen","modification":"2015-01-01 00:00:00"},
{"note":"Reinigung","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Notizdaten werden mit dem Datum der letzten Änderung versehen.

Ändern einer Notiz

URI: /notes/edit/{id}
({id} mit dem entsprechenden Wert ersetzen)

Beispiel für eine Antwort:

{
"id":11,
{"title":"Aufgaben zu erledigen","modification":"2015-01-01 00:00:00"},
{"note":"Reinigung","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Notizdaten werden mit dem Datum der letzten Änderung versehen.

Kalender

Termine abrufen

URI: /calendar

Beispiel für eine Antwort:

[
{"id":99,
"title":{"value":"Ein Abend mit Freunden","modification":"2015-01-01 00:00:00"},
"start":{"value":"2016-01-01 20:00:00","modification":"2015-01-01 00:00:00"},
"end":{"value":"2016-01-01 22:30:00","modification":"2015-01-01 00:00:00"},
"place":{"value":"Bei Bibi","modification":"2015-01-01 00:00:00"},
"del":{"value":1,"modification":"2015-01-01 00:00:00"}
},
{"id":105,
"title":{"value":"Unterricht","modification":"2015-01-01 00:00:00"},
"start":{"value":"2016-09-01 09:00:00","modification":"2015-01-01 00:00:00"},
"end":{"value":"2016-06-30 17:30:00","modification":"2015-01-01 00:00:00"},
"re":{"value":"|N1|N2|N3|N4|N5|","modification":"2015-01-01 00:00:00"}
}
]

Alle Variablen mit einem aufgezeichneten Datum wurden zurückgesendet.

Allgemeine Daten:

Variable Beschreibung
id Eindeutige Kennung des Termins
value Aufgezeichneter Wert
modification Datum, an dem die zugehörigen Daten zuletzt geändert wurden

Veränderbare Daten:

Name Typ Beschreibung
title Kette Titel
start Datum und Uhrzeit Start Datum
end Datum und Uhrzeit Enddatum
description Notizen Beschreibung
place Text Adresse
re Kette Termine abrufen
Wenn Wiederholungen angewandt werden, werden sie durch das |-Zeichen getrennt und wie in den folgenden Beispielen angezeigt.
Ein Wochentag: N gefolgt der Tageszahl (von 1 für Montag bis 7 für Sonntag)
Ein Monatstag: d gefolgt von der Tageszahl (01 bis 31)
Monat: m gefolgt von der Monatszahl (01 bis 12)
Beispiel: |N1|N2|m12| Für eine Wiederholung angewandt auf jeden Montag und Dienstag des Monats Dezember
del Ganzzahl 0, um den Termin wieder herzustellen
1, um den Termin zu löschen

Hinzufügen eines Termins

URI: /calendar/add

Beispiel für eine Antwort:

{
"id":99,
{"title":"Ein Abend mit Freunden","modification":"2015-01-01 00:00:00"},
{"start":"2016-01-01 20:00:00","modification":"2015-01-01 00:00:00"},
{"end":"2016-01-01 22:30:00","modification":"2015-01-01 00:00:00"},
{"place":"Bei Bibi","modification":"2015-01-01 00:00:00"}
}

Termindaten werden mit dem Datum der letzten Änderung versehen.

Einen Termin ändern

URI: /calendar/edit/{id}
({id} mit dem entsprechenden Wert ersetzen)

Beispiel für eine Antwort:

{
"id":99,
{"title":"Ein Abend mit Freunden","modification":"2015-01-01 00:00:00"},
{"start":"2016-01-01 20:00:00","modification":"2015-01-01 00:00:00"},
{"end":"2016-01-01 22:30:00","modification":"2015-01-01 00:00:00"},
{"place":"Bei Bibi","modification":"2015-01-01 00:00:00"},
{"del":0,"modification":"2015-01-01 00:00:00"}
}

Termindaten werden mit dem Datum der letzten Änderung versehen.

SMS

Senden einer SMS

URI: /send/send

Veränderbare Daten:

Name Typ Beschreibung
number Kette Empfänger Nummer im internationalen Format (+CCXXXXXXXXX, wobei CC der Ländercode ist und XXXXXXXXX die lokale Nummer)
message Text Maximal 160 Zeichen pro Nachricht

Beispiel für eine Antwort:

{
"code":1,
"message":"SMS gesendet"
}

Allgemeine Daten:

Variable Beschreibung
code Rückkehrcode - Mögliche Werte:
1: SMS gesendet
2: falsche Nummer
3: unzureichendes Guthaben. Bitte laden Sie Ihr Konto.
4: Quote erreicht. Bitte versuchen Sie es später erneut.
5: interner Fehler. Wenden Sie sich bitte an die Kundenhilfe.
message Beschreibung des empfangenen Codes
DeutschEnglishEspañolFrançaisItalianoNederlandsPortuguêsРусскийそして
© e-nautia[DE] ▲ Nutzungsbedingungen Newsletter Kontakt Hilfe