Sposta un'integrazione dalla v1 alla v2
V1 rimane disponibile. Migra le singole integrazioni quando sono pronte utilizzando la stessa chiave e il saldo del credito. V2 è un contratto di richiesta e risposta diverso, quindi modificare solo l'URL non è sufficiente.
| Concetto V1 | Equivalente V2 |
|---|---|
| Endpoint separati per nome, email e nome utente | POST /api/v2/gender con type e value |
| Separa più endpoint | POST /api/v2/gender/batch con items |
| askToAI | options.ai_mode: fallback; le richieste singole sono già predefinite su fallback |
| forceToGenderize | Stesso campo opzionale per tutti e tre i tipi; prima il set di dati, poi l'intelligenza artificiale con riconoscimento del nickname |
| Campi di risposta piatti | data per il risultato; meta per accesso e fatturazione |
| probability percentuale | confidence su una scala 0–1 più confidence_kind; I punteggi dell'intelligenza artificiale non sono probabilità calibrate |
| total_names | data.sample_count, annullabile |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Formato errore precedente | Stato HTTP più Problem Details code e action |
| POST riprova | Ogni nuovo tentativo è una nuova operazione con fatturazione normale |
Aggiorna e verifica il tuo cliente
Utilizza il contratto di richiesta e risposta v2 per l'integrazione di cui stai eseguendo la migrazione. Verifica meta.access.mode, preserva i risultati di JSON null, controlla gli errori batch per articolo e controlla la fatturazione prima di riprovare. Mantieni le integrazioni v1 sui percorsi esistenti fino all'aggiornamento dei client.