1. Home
  2. Docs
  3. Gateway
  4. HTTP Api
  5. Kontakte

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

ParameterBeschreibung
actionread = Kontakte auslesen
write = Kontakt erstellen/bearbeiten
del = Kontakt löschen

Zusätzliche Parameter

ParameterBeschreibung
json1 = 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:

ParameterBeschreibung
idID des Kontakts, der bearbeitet werden soll. Wenn dieser Parameter leer ist, wird ein neuer Kontakt erstellt.
nickName des Eintrags.
empfaengerDie jeweilige Handynummer.
emailEmail 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.

Was this article helpful to you? Yes No
Menü