GenderAPI.io V2 mit Zapier verbinden

Konto und Quelleintrag vorbereiten

Dieses Beispiel reichert Einträge in Mailchimp anhand der E-Mail-Adresse 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 Zapier konfigurieren

• Beginnen Sie mit einem Mailchimp-Trigger, der den richtigen Abonnenteneintrag liefert. Bewahren Sie die IDs der Zielgruppe (Audience) und des Kontakts auf und fügen Sie vor der HTTP-Aktion einen Filter hinzu, der leere E-Mail-Adressen überspringt.
• Wählen Sie Webhooks by Zapier und die Aktion POST. Geben Sie die folgende URL und Payload Type: JSON an. Fügen Sie die Datenfelder type = email, value = zugeordnete E-Mail-Adresse des Abonnenten und options__ai_mode = off hinzu.
• Die Schreibweise mit doppeltem Unterstrich verschachtelt options__ai_mode in Zapier als options.ai_mode im JSON-Body. Der folgende Codeblock zeigt den Body, den die API erhält; er ist kein viertes Feld, das Sie in die Aktion einfügen.
• Fügen Sie im Bereich Headers Authorization mit dem Wert Bearer YOUR_API_KEY hinzu. Verwenden Sie application/json als Content-Type. Schreiben Sie den Schlüssel nicht in Trigger-Felder, in die Abfragezeichenfolge oder in Beispielantworten.

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": "email",
  "value": "alex@example.com",
  "options": {
    "ai_mode": "off"
  }
}

• Anfragefelder, Typen und Standardwerte →

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

Webhook-Header sind kein eigenes Feld für Geheimnisse: Wer den Zap bearbeiten kann, sieht sie. Beschränken Sie den Zugriff und teilen Sie weder den Zap noch Bildschirmfotos oder Exporte, die Zugangsdaten enthalten. Zapier bietet auch API by Zapier mit gespeicherten Zugangsdaten an, doch die Konfiguration des Anfrage-Bodys unterscheidet sich dort von diesem strukturierten POST-Rezept.

Umhüllen Sie den Body nicht: Senden Sie ein einzelnes Objekt, keine Liste und kein Array. Wählen Sie für zugeordnete Kundendaten die strukturierte JSON-Aktion; Custom Request sendet Rohtext und maskiert Sonderzeichen in eingefügten Werten nicht automatisch.

• Strukturierte Webhook-Anfragen und verschachteltes JSON in Zapier →
• Verbindungen mit Zugangsdaten in API by Zapier →
• Verhalten der Wiederholung (Replay) in Zapier →

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

Prüfen Sie die ausgewertete Antwort der Testaktion und wählen Sie die Felder für data.gender, data.result_status und die übrigen oben genannten V2-Pfade. Die Feldauswahl von Zapier kann verschachtelte Bezeichnungen abflachen: Orientieren Sie sich am beobachteten Wert und am übergeordneten Pfad, statt das ältere Feld probability des nativen Konnektors vorauszusetzen. Aktualisieren Sie nur den Mailchimp-Abonnenten, dessen ID bewahrt wurde.

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

Prüfen Sie vor dem Aktivieren des Zaps die Einstellungen für Autoreplay und die manuelle Wiederholung (Replay) in Zapier. Die Wiederholung einer fehlgeschlagenen Webhook-Aktion sendet eine neue Anfrage; wiederholen Sie eine erfolgreiche Anfrage nicht, nur um einen späteren Mailchimp-Schritt zu reparieren. Speichern Sie die ursprünglichen Abonnenten-IDs und das Ergebnis der Anfrage zusammen.

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