Flytta en integration från V1 till V2
GenderAPI.io V1 är fortfarande tillgängligt. Flytta varje integration till V2 med samma API-nyckel och samma kreditsaldo. V2 har ett annat kontrakt för förfrågningar och svar, så det räcker inte att bara byta URL: uppdatera rutt, förfrågningsfält och hanteringen av svar samtidigt. V2 använder data för resultat och meta för uppgifter om förfrågan, åtkomst och debitering.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender med type: name, email eller username och value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch med items; indatatyper kan blandas. |
| /api/phone med number och address | POST /api/v2/phone/validate med number och country; läs data.valid och data.possible. |
| askToAI | options.ai_mode: fallback; enskilda förfrågningar använder redan fallback som standard |
| forceToGenderize | Samma valfria fält för alla tre typerna; först datamängden, sedan AI med tolkning av smeknamn |
| Platta svarsfält | data för resultatet; meta för åtkomst och debitering |
| probability i procent | confidence på en skala från 0 till 1 plus confidence_kind; AI-värden är inga kalibrerade sannolikheter |
| total_names | data.sample_count, kan vara null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Tidigare felformat | HTTP-status plus code och action enligt Problem Details |
| Nya försök med POST | Varje nytt försök är en ny åtgärd med vanlig debitering |
Uppdatera och kontrollera din klient
Använd kontraktet för förfrågningar och svar i V2 för den integration du flyttar. Kontrollera meta.access.mode, behåll null-resultat i JSON, kontrollera batchfel per post och kontrollera debiteringen innan du försöker igen. Låt V1-integrationer ligga kvar på sina befintliga sökvägar tills deras klienter har uppdaterats.