Kontakte

Fragen Sie über die Kontakte Api Ihr Adressbuch ab und bearbeiten, löschen oder erstellen Sie Einträge.

Bitte richten Sie Ihren Request an diese URL:

https://gateway.sms77.io/api/contacts

Benötigte Parameter

Zusätzlich zur Authentifizierung werden folgende Parameter benötigt

Parameter	Beschreibung
action	read = Kontakte auslesen write = Kontakt erstellen/bearbeiten del = Kontakt löschen

Zusätzliche Parameter

Parameter	Beschreibung
json	1 = Ausgabe im JSON Format 0 = Ausgabe als CSV bzw plain Text (Standard)

Kontakte auslesen

Über action=read werden die ID des Eintrages, welche benötigt wird um Einträge zu löschen/bearbeiten, dann der Name, dann die Nummer und zuletzt die E-Mail-Adresse ausgegeben, jeweils getrennt von einem Semikolon. Je Zeile wird ein Datensatz ausgegeben.

Beispiel

Request:
https://gateway.sms77.io/api/contacts?p=api-key&action=read

Response:
1234;Max;0049179999999999;max@email.de
2189;Horst;0049171999999999;

Kontakt bearbeiten/erstellen

Um einen Eintrag zu bearbeiten, geben Sie bitte action=write und zusätzlich die folgenden Parameter an:

Parameter	Beschreibung
id	ID des Kontakts, der bearbeitet werden soll. Wenn dieser Parameter leer ist, wird ein neuer Kontakt erstellt.
nick	Name des Eintrags (maximal 50 Zeichen)
empfaenger	Die jeweilige Handynummer.
email	Email Adresse

nick, empfaenger und email sind jeweils optional. Im Erfolgsfall erhalten Sie den Code 152 zurück gefolgt von der erstellten ID in der nächsten Zeile, sofern ein neuer Kontakt erstellt wurde. Im Fehlerfall erhalten Sie den Code 151.

Beispiel

Request:
https://gateway.sms77.io/api/contacts?p=api-key&action=write&empfaenger=491761234567890&nick=Testeintrag&json=1

Response:
{"return":"152","id":1256066}

Kontakt löschen

Mit action=del und id=ID_des_Kontakts wird ein Eintrag gelöscht.

Beispiel

Request:
https://gateway.sms77.io/api/contacts?p=api-key&action=del&id=2189

Falls der Eintrag gelöscht wurde, wird 152 zurückgegeben, ansonsten 151.