getCalls method

Future<RestApiResponse> getCalls({
  1. String query = '',
  2. int page = 0,
  3. int? perPage,
  4. String serialization = '',
  5. String rightsControlKey = '',
})

Ruft Anruflisten und Telefonie-Daten ab

Lädt Anrufinformationen, Anruflisten und Telefonie-bezogene Daten mit Filterung und Paginierung.

query - Suchfilter für Anrufdaten page - Seitenzahl für Paginierung (Standard: 0) perPage - Anzahl Einträge pro Seite (Standard: aus Konfiguration) serialization - Serialisierungsoptionen für die Ausgabe rightsControlKey - Berechtigungsschlüssel für Zugriffskontrolle

Returns: RestApiResponse mit Anrufdaten und Telefonie-Informationen

Beispiel:

RestApiResponse response = await api.v1.integrations.getCalls(
  query: "direction:incoming",
  page: 1
);
if (response.isOk) {
  List calls = response.data['calls'];
}

Hinweis zur neuen API: Lädt Anrufe/Calls (GET v1/calls); perPage fällt auf den Runtime-Konfigurationswert zurück und wird immer gesendet.

Implementation

Future<RestApiResponse> getCalls({
  String query = '',
  int page = 0,
  int? perPage,
  String serialization = '',
  String rightsControlKey = '',
}) {
  final Map<String, String> params = <String, String>{};
  if (query.isNotEmpty) params['query'] = query;
  if (page != 0) params['page'] = page.toString();
  params['perPage'] = (perPage ?? _runtime.configuration.perPageCount)
      .toString();
  if (serialization.isNotEmpty) params['serialization'] = serialization;
  if (rightsControlKey.isNotEmpty) {
    params['rightsControlKey'] = rightsControlKey;
  }

  return _runtime.execute(
    ApiRequest<RestApiResponse>(
      method: ApiHttpMethod.get,
      version: ApiVersion.v1,
      path: '/calls',
      queryParameters: params,
      authentication: AuthenticationPolicy.session,
      deduplication: DeduplicationPolicy.enabled,
      responsePolicy: _responsePolicy,
      operationId: 'v1.integrations.getCalls',
    ),
  );
}