Anruf HTTP GET Schnittstelle V2: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
Keine Bearbeitungszusammenfassung |
||
| Zeile 3: | Zeile 3: | ||
Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php | Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php | ||
Übergabe per GET oder POST (GET hat Vorrang vor POST) | Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST) | ||
Version vom 7. Februar 2024, 07:36 Uhr
Neue 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]