FAQ: Häufig gestellte Fragen

Allgemeine Fragen

Was ist die Multisource API?	Die Multisource API ist eine zentrale Lösung für die Verarbeitung, Validierung und Anreicherung von Daten. Sie ermöglicht es Unternehmen, die Qualität ihrer Daten zu verbessern, zusätzliche Informationen zu nutzen und Datenprozesse zu automatisieren.
Welchen Mehrwert bietet die Multisource API für mein Unternehmen?	Die Multisource API bietet zahlreiche Vorteile für Unternehmen, darunter: Verbesserte Datenqualität: Durch die Validierung und Bereinigung von Daten können Fehler minimiert und die Datenqualität verbessert werden. Effiziente Datenanreicherung: Bestehende Daten können mit zusätzlichen Merkmalen wie Geo-Koordinaten oder Rubrikeninformationen ergänzt werden, was tiefere Analysen und gezielte Marketingmassnahmen ermöglicht. Automatisierte Datenprozesse: Mit minimalem manuellen Aufwand stehen Ihnen stets aktuelle und optimierte Daten zur Verfügung, was die Effizienz Ihrer Geschäftsprozesse erhöht. Kostenkontrolle: Durch die Möglichkeit, eine Kostenobergrenze festzulegen, können unerwartete Ausgaben vermieden und die Planungssicherheit gewährleistet werden.
Welche Datenquellen nutzt die Multisource API?	Die Multisource API greift auf eine Vielzahl hochqualifizierter Datenquellen zu, darunter Swisscom Directories AG, KünzlerBachmann kbBUILDING, kbCONSUMER und kbBUSINESS und der Schweizerischen Post. Diese Quellen bieten hohe Präzision, breite Abdeckung und Flexibilität.

Technische Fragen

Wie erhalte ich Zugriff auf die Multisource API?	Um Zugriff auf die Multisource API zu erhalten, müssen Sie ein OAuth2-Benutzerkonto erstellen. Besuchen Sie dazu die Webseite https://auth.local.ch/login, registrieren Sie sich mit Ihrer E-Mail-Adresse und aktivieren Sie Ihr Konto über den Link in der zugesandten E-Mail.
Welche Authentifizierungsmethode wird verwendet?	Die Multisource API verwendet OAuth2-Authentifizierung. Ein gültiges Token muss in jedem Request im Header Authorization: Bearer <TOKEN> hinzugefügt werden.
Wie kann ich die API-Endpunkte testen?	Die Swagger-Dokumentation bietet eine interaktive Endpunktübersicht, mit der Sie Funktionen direkt aus der Swagger-Oberfläche testen können. Sie können die Swagger-Dokumentation auch in Tools wie Postman importieren, um einfache Tests durchzuführen.
Welche Datenformate werden unterstützt?	Die Multisource API akzeptiert eine Vielzahl von Formaten für Eingabedaten, darunter CSV, TSV, TXT und jegliche tabellarische Dateiformate. Die API ermöglicht die flexible Konfiguration der Verarbeitung, um spezifische Formatanforderungen des Kunden zu unterstützen.

Kosten und Abrechnung

Wie kann ich die Kosten für die Nutzung der API kontrollieren?	Um unerwartete Kosten zu vermeiden, bietet die Multisource API die Möglichkeit, eine Kostenobergrenze (Cost Cap) festzulegen. Sie können ein monatliches Limit festlegen und Benachrichtigungen per E-Mail oder Webhook erhalten, sobald 80% und 100% der Obergrenze erreicht sind.
Was passiert, wenn ich mein Kostenlimit erreiche?	Wenn Sie Ihr Kostenlimit erreichen, pausiert die API automatisch. Für eine erweiterte Nutzung kann Ihr Konto nach Rücksprache freigeschaltet werden.

Sicherheit und Datenschutz

Wie wird die Sicherheit meiner Daten gewährleistet?	Die Multisource API verwendet mehrere Schutzmechanismen, um höchste Sicherheitsstandards zu gewährleisten. Dazu gehören OAuth2-Authentifizierung, Transportverschlüsselung über HTTPS, optionale kundenseitige Verschlüsselung, IP-Whitelisting und Ratenbegrenzung.
Ist die Multisource API DSGVO-konform?	Ja, alle Datenverarbeitungen der Multisource API entsprechen den gesetzlichen Vorgaben der DSG. Die API bietet auch eine Audit-Funktion, mit der alle API-Aufrufe protokolliert und überprüft werden können.

Use Cases und Anwendungsfälle

Welche Use Cases unterstützt die Multisource API?	Die Multisource API unterstützt eine Vielzahl von Use Cases, darunter Adresse erfassen, Person suchen/matchen, Firma suchen/matchen, Anrufer identifizieren, Adresse validieren, Adresse aktualisieren, Personen/Firmen-Referenzierung, Kriterien anreichern und potentielle Neukunden identifizieren.
Wie kann ich die API für die Adressvalidierung nutzen?	Um die API für die Adressvalidierung zu nutzen, können Sie die Match-Funktion verwenden. Diese führt einen Abgleich über alle berechtigten Datenquellen hinweg durch und ermittelt den besten Treffer basierend auf einer vorab definierten Priorisierung der Quellen.
Kann ich die API für die Suche nach Personen und Firmen nutzen?	Ja, die Multisource API bietet sowohl Search- als auch Match-Funktionen, die für die Suche nach Personen und Firmen genutzt werden können. Die Search-Funktion ermöglicht eine gezielte Suche innerhalb einer spezifischen Datenquelle, während die Match-Funktion einen Abgleich über alle berechtigten Datenquellen hinweg durchführt.

Fehlerbehebung und Support

Wie kann ich Fehler bei API-Aufrufen beheben?	Die Multisource API bietet integrierte Logging-Funktionen. Jeder Request kann mit einer eindeutigen RequestId verfolgt werden, die für Debugging und Fehleranalyse genutzt werden kann. Bei häufigen Fehlermeldungen können Sie unser Support-Team kontaktieren.
Wie kann ich den Support kontaktieren?	Unser Support-Team steht Ihnen bei allen Fragen rund um die Multisource API zur Verfügung. Sie können uns per E-Mail erreichen.
Bietet die Multisource API erweiterten Support?	Ja, für geschäftskritische Anwendungen bieten wir Service-Level-Agreements (SLAs) mit garantierten Reaktionszeiten an. Unser Team hilft Ihnen auch, die API schnell und effizient zu integrieren.