We zijn er trots op ons nieuwe API V2.0-endpoint met een veel modernere interface te presenteren

Als je een gevorderde gebruiker bent met veel verzoeken, kun je overstappen op ons nieuwe API V2.0-endpoint. De Unified API is veel sneller en biedt een robuustere interface bij het opvragen van meerdere namen in één verzoek, maar is iets complexer om te implementeren.

Vraag maximaal 100 namen op in één verzoek

Je kunt tot 100 namen in één enkel verzoek indienen en je kunt de invoergegevens zelfs door elkaar gebruiken. Bijvoorbeeld, een naam kan worden ingediend met een landcode, terwijl een andere naam wordt ingediend zonder landcode - allemaal in één enkele opdracht.

Tot wel 200 keer sneller

We hebben dit nieuwe endpoint ontwikkeld met een handvol van onze grootste klanten, om aan hun eisen op het gebied van snelheid, stabiliteit en schaalbaarheid te voldoen. Vergeleken met verzoeken die meerdere namen tegen ons v1-endpoint opvragen, is dit endpoint tot 20 keer sneller.

Veiliger

Je kunt nu unieke authenticatietokens genereren voor al je projecten. Deze tokens kunnen indien nodig op elk moment ingetrokken worden. Je kunt je authenticatietokens beheren hier.

Maak een proefrit

Om je een idee te geven hoe eenvoudig het is om met dit JSON-API-endpoint te communiceren, vind je een voorbeeld op codepen.io.

Codepen.io zal verbinding maken met je Gender-API.com account en je een basisvoorbeeld geven van hoe de invoerdata eruit ziet en wat de reactie zal zijn.

Live testen met codepen.io

Een enkele naam opvragen

{"first_name":"Sandra"}

Meerdere namen opvragen

[{"first_name":"Sandra"}, {"first_name":"Mike", "country":"US"}]

Was dat niet makkelijk? We hebben gewoon vierkante haakjes rond de twee naamobjecten toegevoegd en dit vertelt onze API "geef alsjeblieft ook het resultaat terug als een array". Je kunt tot 100 namen opvragen in één REST API-oproep.

Je kunt het geslacht van een e-mailadres net zo gemakkelijk bepalen als het geslacht van een voornaam. Voeg eenvoudigweg een veld email toe aan de JSON van het verzoek in plaats van een veld first_name. De technologie achter het bepalen van het geslacht van een e-mailadres is echter veel ingewikkelder. Verschillende verwerkingsalgoritmes werken samen om je de best mogelijke resultaten te geven.

{"email":"theresa.miller14@gmail.com"}

Is de bestaande V1.0 API nu verouderd?

Nee, V1.0 levert een zeer eenvoudig te integreren interface terwijl V2.0 beter geschikt is voor klanten met een groot aantal verzoeken. Beiden zullen evenveel ontwikkeld en onderhouden worden.

Bekijk de API-documentatie

We hopen dat we je een kort overzicht en een snelle introductie van onze nieuwe Genderize API hebben kunnen geven. Je kunt alle technische informatie, geavanceerde functies en voorbeelden vinden in onze API-documenten sectie. Als je vragen hebt, neem gerust contact op met ons team.