GenderAPI.io V2 mit Integrately verbinden

Konto und Quelleintrag vorbereiten

Dieses Beispiel reichert Einträge in Mailchimp anhand des Vornamens an. Sie benötigen Zugriff auf die Quell- und die Zielanwendung, einen GenderAPI.io-Kontoschlüssel und die Plattformfunktionen, die die HTTP-Aktion verwendet. Diese Anleitung enthält keine funktionierenden Zugangsdaten und keine verbundenen Konten.

V1 und V2 verwenden denselben Kontoschlüssel und dasselbe Guthaben. Bevor Sie eine kostenpflichtige Anfrage einrichten, prüfen Sie den Schlüssel mit GET /api/v2/usage und stellen Sie sicher, dass meta.access.mode in der Antwort dieses Endpunkts den Wert api_key hat. Ein fehlender oder nicht erkannter Schlüssel kann dazu führen, dass der gemeinsame IP-Testzugang verwendet wird; eine produktive Automatisierung sollte diesen nicht unbemerkt nutzen.

Lassen Sie den Workflow während der Einrichtung deaktiviert. Eine Testvorhersage verbraucht gewöhnliche Credits. Diese Anleitungen wurden anhand der öffentlichen Dokumentation und des V2-Vertrags geprüft; für diese Veröffentlichung wurde auf keiner Plattform ein authentifizierter Workflow vollständig von Anfang bis Ende ausgeführt.

• Authentifizierung und kostenlose Nutzungsprüfung →

Die GenderAPI.io-V2-Anfrage in Integrately konfigurieren

• Wählen Sie einen Mailchimp-Abonnenten-Trigger und prüfen Sie einen Testeintrag. Bewahren Sie die IDs der Zielgruppe (Audience) und des Abonnenten für die Aktualisierung auf, wählen Sie das tatsächliche Vornamensfeld und überspringen Sie Einträge ohne Vornamen.
• Suchen Sie Webhook/API und die zugehörige Aktion zum Senden von Daten an eine URL. Prüfen Sie die verfügbare Konfiguration, bevor Sie fortfahren: Der folgende Vertrag erfordert authentifizierte Header und einen verschachtelten JSON-Body, und die aktuellen Bedienelemente des Editors wurden hier nicht unabhängig geprüft.
• Erfüllt die Aktion diese Anforderungen, wählen Sie POST und den folgenden V2-Endpunkt. Sorgen Sie mit den in Ihrem Konto verfügbaren Bedienelementen dafür, dass die ausgehende Anfrage Authorization: Bearer YOUR_API_KEY und Content-Type: application/json enthält.
• Erstellen Sie einen JSON-Body mit type = name, value = zugeordneter Vorname und options mit ai_mode = off. Prüfen Sie die Vorschau der Anfrage der gewählten Aktion: Eine flache Formularnutzlast ist kein V2-JSON-Body, auch wenn der Header Content-Type gesetzt ist.
• Verwenden Sie für dynamische Vornamen die Zuordnungs- oder JSON-Serialisierungs-Bedienelemente der Plattform. Kann die gewählte Aktion kein verschachteltes JSON oder keine authentifizierten Header beibehalten, verwenden Sie einen HTTP-fähigen Schritt, statt den Schlüssel oder das JSON in Abfrageparameter zu schreiben.

JSON-Body vor dem Senden prüfen

Dieses Beispiel zeigt eine feste Eingabe; es ist kein vorhergesagtes Ergebnis. Prüfen Sie zuerst die Struktur der Anfrage und ersetzen Sie dann value durch das zugeordnete Quellfeld, mit korrekter JSON-Serialisierung. Senden Sie Zuordnungsausdrücke der Plattform nicht als wörtlichen Text an die API.

Setzen Sie für andere Eingaben type auf name, email oder username und geben Sie den passenden Wert in value an. Fügen Sie country nur hinzu, wenn Sie verlässlichen Kontext haben: Das Feld ist optional und dient nicht dazu, das Wohnsitzland zu bestimmen.

{
  "type": "name",
  "value": "Alice",
  "options": {
    "ai_mode": "off"
  }
}

• Anfragefelder, Typen und Standardwerte →

Den HTTP-Schritt prüfen, bevor Sie Aktualisierungen aktivieren

Testen Sie gezielt eine Aktion und prüfen Sie den zurückgegebenen Body, bevor Sie Felder in nachfolgenden Schritten auswählen. Native GenderAPI.io-Schritte und Webhook/API-Schritte können unterschiedliche Feldbezeichnungen anzeigen, selbst für denselben Quellkunden.

Bewahren Sie den Schlüssel in den dafür vorgesehenen Bedienelementen für Verbindung oder Anfrageauthentifizierung auf und beschränken Sie den Personenkreis, der die Automatisierung ansehen oder teilen kann. Dieser öffentliche Leitfaden enthält weder einen funktionierenden Schlüssel noch eine exportierte Verbindung oder eine vorkonfigurierte Kundenaktualisierung.

• Webhook/API-Aktionen in Integrately →
• Dokumentation von Integrately →

Ergebnisse identified, unknown und Fehler getrennt behandeln

Werten Sie den Antwort-Body aus, bevor Sie eine Zielaktualisierung auswählen. Die folgenden JSON-Pfade beziehen sich auf den V2-Antwort-Body; Ihre Plattform kann ihn umhüllen oder abflachen. Bestätigen Sie die tatsächlich zurückgegebene Struktur in einem gezielten Test und speichern Sie das Ergebnis zusammen mit der ID des Quelleintrags.

Eine Vorhersage bestimmt weder die Identität einer Person noch das Geschlecht, das diese Person selbst angibt. Bewahren Sie sie getrennt von Angaben der Person selbst auf. Legen Sie Akzeptanzkriterien anhand repräsentativer Daten aus Ihrem eigenen Anwendungsfall fest und bewerten Sie die Konfidenz aus dem Datensatz und die KI-Konfidenz getrennt.

• Vollständige Dokumentation der V2-Antwort →
• Fehler und Entscheidungen über Wiederholungen →

Nur den passenden Eintrag in Mailchimp aktualisieren

Verwenden Sie die gespeicherten Mailchimp-IDs der Zielgruppe (Audience) und des Abonnenten, um den Zieleintrag auszuwählen. Fügen Sie Bedingungen zum Ergebnisstatus sowie zu den oben beschriebenen Prüfungen von Zugang und Abrechnung hinzu, bevor Sie Daten in ein eigenes Feld für abgeleitete Angaben oder einen genehmigten Tag schreiben. Wandeln Sie ein fehlendes Geschlecht oder den Wert null niemals in eine Standardkategorie des Kontakts um.

Testen Sie die Zweige für ein Ergebnis identified, ein Ergebnis unknown und einen Fehler, bevor Sie Aktualisierungen aktivieren. Mit fiktiven Beispielantworten lassen sich die Verzweigungsbedingungen prüfen, ohne eine neue Vorhersage zu senden. Die Aktualisierung in der Zielanwendung sollte von den obigen Prüfungen abhängen und darf keine unabhängigen Felder oder Tags überschreiben.

• Antwortfelder und unbekannte Ergebnisse →
• Genauigkeit und Konfidenz erklärt →
• Datenquellen und das datierte Datenbankprofil →

Wiederholungen und erneute Abbuchungen kontrollieren

Integrately dokumentiert automatische Wiederholungen, einschließlich unternehmensweit geltender Einstellungen. Prüfen Sie vor dem Aktivieren dieser Automatisierung die Richtlinie und den Aufgabenverlauf und bewerten Sie vor dem Ändern einer gemeinsamen Einstellung die Auswirkungen auf andere Workflows. Jede wiederholte HTTP-Anfrage ist eine unabhängige, kostenpflichtige Anfrage; bewahren Sie erfolgreiche Ausgaben auf, damit Sie einen späteren Fehler in Mailchimp ohne weitere Anfrage reparieren können.

Jede neue Anfrage an GenderAPI ist ein eigenständiger Vorgang. Deduplizieren Sie wiederholte Quellereignisse vor dem Senden in Ihrem eigenen Workflow, anhand der gespeicherten Quell-ID und des Verarbeitungsstatus. Die ID des Quelleintrags ist kein Schlüssel, der serverseitig vor Wiederholungen schützt.

Ein erfolgreiches Ergebnis unknown ist ein vollständiges, kostenpflichtiges Ergebnis. Bei einer Zeitüberschreitung oder einer unvollständigen Antwort können Ergebnis und Abbuchung unbekannt sein: Bewahren Sie die Anfragereferenz auf, sofern vorhanden, und klären Sie die Abrechnung, bevor Sie die Anfrage erneut senden. Beachten Sie den Header Retry-After, wenn er eine Antwort zur Überschreitung des Anfragelimits begleitet.

• Credits und Abrechnungsstatus →

Festlegen, wann KI eingesetzt wird

forceToGenderize ist für Namen, E-Mail-Adressen und Benutzernamen optional. Ist es aktiviert, lassen Sie ai_mode weg oder verwenden Sie fallback; off und always sind damit unvereinbar und liefern 422. Ein positives Anfangsguthaben genügt, um eine Anfrage zu starten, auch wenn die endgültige Abbuchung das Guthaben unter null senkt.

Der Spitznamenmodus kann ein Geschlecht zusammen mit name: null zurückgeben. Er kann auch ein unbekanntes Ergebnis liefern. Weder der gewöhnliche KI-Fallback noch die Spitznamen-Auswertung garantieren eine richtige Antwort oder einen Wert ungleich null.

• KI-Optionen und Spitznamen-Auswertung →
• Credits und Nutzung →

Workflow prüfen, bevor Sie das Volumen erhöhen

• Prüfen Sie in einem gezielten Test das tatsächlich serialisierte JSON, die ausgewerteten Ergebnispfade, den Zugang per API-Schlüssel und die Bestätigung der Abrechnung. Testen Sie, wo möglich, die Behandlung von Ergebnissen unknown und von Fehlern mit Beispielantworten.
• Klären Sie, welche Workflow-Schritte wiederholt werden und welche Kundenfelder sich ändern. Bewahren Sie die ID des Quelleintrags, die erhaltene Antwort und die Referenz der Anfrage auf, damit ein späterer Fehler im Zielsystem keine weitere Anfrage erfordert.
• Aktivieren Sie zuerst einen kleinen, kontrollierten Lauf und prüfen Sie dessen Einträge und Credits, bevor Sie die Parallelität erhöhen. GenderAPI-Credits und die von der Automatisierungsplattform abgerechneten Aufgaben oder Operationen sind getrennte Kosten.
• Verwenden Sie für Batches POST /api/v2/gender/batch mit bis zu 50 Einträgen beim Zugang per API-Schlüssel oder 10 im IP-Testzugang. Das Array items kann Namen, E-Mail-Adressen und Benutzernamen kombinieren, mit ausdrücklichen Optionen und einer eindeutigen id für jeden Eintrag. Prüfen Sie jedes Ergebnis: Eine Antwort mit HTTP 200 kann Teilfehler enthalten. Die Batch-Unterstützung eines nativen Konnektors muss gesondert geprüft werden.

• Batches und Teilfehler →
• Implementierungsleitfaden für Python →
• Implementierungsleitfaden für Node.js →

Häufige Fragen