Anruf HTTP GET Schnittstelle V2: Unterschied zwischen den Versionen

Aus infra-struktur AdminWiki 2.10
Zur Navigation springenZur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
'''Neue Anruflisten API'''
'''Anruflisten API'''


  Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php
  Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php

Version vom 22. August 2025, 09:44 Uhr

Anruflisten API

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)


Folgende Werte müssen übergeben werden:

isdnKey - Der ISDN-Key.
location - Der Name eines in der Anrufliste konfigurierten Standortes.
msn - Der Name einer in der Anrufliste konfigurierten eingehenden Rufnummern/Nebenstellen. 
number - Die Nummer des Anrufers.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)


Folgende Werte können übergeben werden:

reason - Der base64 codierte Grund eines Anrufes.
fileSource - Der base64 codierte Inhalt einer Datei.
fileType - Der Typ einer Datei. Der Standardwert liegt auf „fax“.
mimeType - Der mimetype einer Datei. Der Standardwert liegt auf „application/download“.
timestamp - Ein Unixtimestamp mit der der Eintrag erzeugt werden soll. Der Standardwert liegt auf dem Zeitpunkt des Aufrufs.
direction - entweder "in" oder "out für eingehende oder ausgehende Anrufe. Default ist "in".


Es können folgende Fehlerwerte auftreten:

1001 - MISSING_MANDATORY_REQUEST_PARAM_ISDNKEY

Meldung: „isdnKey“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1002 - MISSING_MANDATORY_REQUEST_PARAM_LOCATION

Meldung: „location“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1003 - MISSING_MANDATORY_REQUEST_PARAM_MSN

Meldung: „msn“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1004 - MISSING_MANDATORY_REQUEST_PARAM_NUMBER

Meldung: „number“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)


2001 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_HOST

Meldung: „host“ database connection param is mandatory, please contact the support

2002 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_USERNAME

Meldung: „username“ database connection param is mandatory, please contact the support

2003 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_PASSWORD

Meldung: „password“ database connection param is mandatory, please contact the support

2004 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_DATABASE

Meldung: „database“ database connection param is mandatory, please contact the support


3001 - DATABASE_CONNECTION_CREATE

Meldung: Connection Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3101 - DATABASE_QUERY_ON_VALIDATE_ISDNKEY_IN_DB

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3102 - DATABASE_QUERY_ON_GET_LOCATIONID_BY_LOCATIONNAME

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location id by location name

3103 - DATABASE_QUERY_ON_GET_LOCATION_CONFIGURATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location configuration

3104 - DATABASE_QUERY_ON_GET_INTERNATIONAL_PREFIX_ID_BY_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the internationalPrefixId

3105 - DATABASE_QUERY_ON_IS_MSN_A_FAX_MSN_FOR_MSN_AND_LOCATIONID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while checking if the msn is a fax msn

3106 - DATABASE_QUERY_ON_CHECK_SIGNAL_TOLERANCE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3107 - DATABASE_QUERY_ON_GET_LIST_ID_FOR_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the list id for msn and location id

3108 - DATABASE_QUERY_ON_GET_NUMBER_TO_NAME_ID_BY_NUMBER

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3109 - DATABASE_QUERY_ON_GET_MSN_ID_BY_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the msn id by msn and location id

3110 - DATABASE_QUERY_ON_INSERT_ENTRY

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3111 - DATABASE_QUERY_ON_CITY_NAME_BY_PREFIX_AND_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3112 - DATABASE_QUERY_ON_FORMAT_NUMBER_WITH_LOCATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3113 - DATABASE_QUERY_ON_INSERT_CALL_TO_CALLLIST

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3114 - DATABASE_QUERY_ON_INSERT_FILE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3115 - DATABASE_QUERY_ON_SET_REASON

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3116 - DATABASE_QUERY_ON_GET_COUNTRY_NAME_FOR_NATIONAL_PREFIX_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]


4001 - API_INVALID_ISDNKEY

Meldung: the provided isdn key „[isdnKey]“ is not valid

4002 - API_NOT_VALIDATED

Meldung: you first need to validate your isdn key

4101 - API_MINIMUM_NUMBER_LENGTH

Meldung: the number „[number]“ is below the required minimum number length of [minimumNumberLength]

4102 - API_NUMBER_IS_HIDDEN_SIGNAL

Meldung: the number „[number]“ is the hidden signal „[hiddenSignal]“

4103 - API_CALL_IS_WITHIN_SIGNAL_TOLERANCE

Meldung: the call from the number „[number]“ is within the signal tolerance of [signalTolerance] seconds

4104 - API_NO_CALLLIST_FOUND

Meldung: no appropriate call list found for MSN „[msn]“ and location id [locationId]