GenderAPI.io V2 mit Make verbinden

Konto und Quelleintrag vorbereiten

Dieses Beispiel reichert Einträge in Shopify 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 Make konfigurieren

• Wählen Sie einen zu Ihrem Szenario passenden Shopify-Kunden-Trigger und laden Sie einen repräsentativen Testeintrag. Bewahren Sie die Kunden-ID für die abschließende Aktualisierung auf und überspringen Sie Einträge mit leerer E-Mail-Adresse.
• Fügen Sie HTTP > Make a request hinzu. Wählen Sie in der aktuellen HTTP-App die Authentifizierung API key und legen Sie Zugangsdaten mit dem Schlüsselwert Bearer YOUR_API_KEY, dem Ort Header und dem Parameternamen Authorization an. Nutzen Sie diese Zugangsdatenverwaltung, statt den Schlüssel in die URL zu schreiben.
• Setzen Sie die Methode auf POST und die folgende URL. Wählen Sie application/json für den Anfrage-Body sowie eine Datenstruktur mit den Textfeldern type und value und einer Sammlung options mit dem Textfeld ai_mode. Setzen Sie type auf email und ai_mode auf off und ordnen Sie dann die E-Mail-Adresse des Kunden value zu.
• Aktivieren Sie Parse response. Ein mit einer Datenstruktur von Make erstellter Body serialisiert die zugeordneten Werte als JSON, sodass Namen oder Adressen mit Anführungszeichen keine manuelle Textverkettung erfordern.

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

Lassen Sie Weiterleitungen für dieses feste HTTPS-API-Ziel deaktiviert. Wenn Sie die Version der HTTP-App von Make wechseln, prüfen Sie die Einstellungen für Authentifizierung und Anfrage-Body erneut: Ihre Bedienelemente können sich unterscheiden.

Führen Sie einen gezielten Test aus, prüfen Sie das ausgewertete Antwortpaket (Bundle) und legen Sie getrennte Pfade für akzeptierte Ergebnisse identified, Ergebnisse unknown und Betriebsfehler an, bevor Sie die Kundenaktualisierung hinzufügen.

• Einrichtung der HTTP-App bei Make →
• Zugangsdaten API key und Ort Header bei Make →
• Automatische Wiederholung unvollständiger Ausführungen bei Make →

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 Shopify aktualisieren

Ordnen Sie in der ausgewerteten HTTP-Antwort die oben genannten V2-Body-Pfade zu. Make kann den Body unter einer Ausgabebezeichnung des Moduls ablegen: Wählen Sie die verschachtelten Objekte data und meta aus dem geprüften Bundle. Aktualisieren Sie nur den Kunden, dessen ID der Trigger bewahrt hat, in einem eigenen Feld für abgeleitete Angaben oder nach einer festgelegten Tag-Richtlinie.

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 die Fehlerbehandlungen von Make und die Einstellungen für unvollständige Ausführungen. Einige vorübergehende Fehler können auch ohne ausdrückliche Retry-Behandlung wiederholt werden. Eine Wiederholung des HTTP-Moduls kann eine weitere kostenpflichtige Anfrage senden. War die Anfrage erfolgreich, die spätere Aktualisierung in Shopify aber nicht, verwenden Sie die gespeicherte Ausgabe, um diese Aktualisierung zu reparieren.

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