Crea la tua logica di convalida

Questo documento descrive una procedura per creare un sistema di controllo degli indirizzi per gestire una varietà di risposte dall'API Address Validation. Spiega come crea la tua logica per utilizzare correttamente la risposta, per analizzare altri indicatori dall'API e su quando e come richiedere maggiori informazioni ai clienti.

In generale, la risposta dell'API determina i seguenti modi in cui il sistema dovrebbe gestire un indirizzo:

• handyman Correggi: l'indirizzo è di bassa qualità. Dovresti richiedere ulteriori informazioni.
• edit Conferma: l'indirizzo è di alta qualità, ma presenta cambia dall'indirizzo di input. Potresti richiedere conferma.
• check Accetta: l'indirizzo è di alta qualità. Puoi accetta l'indirizzo fornito.

Scopo principale

Questo documento ti aiuta a modificare il tuo sistema per analizzare al meglio la risposta dell'API e determinare le azioni successive da intraprendere con gli indirizzi forniti. Le seguenti pseudocodice illustra un possibile flusso.

if (the API response indicates significant problems in the address)
    FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
    CONFIRM - confirm with the user that the address is correct
else
    ACCEPT - continue with the address returned by the API.

La logica esatta dipende dalla situazione. Consulta la guida all'implementazione. per ulteriori informazioni. Puoi anche usare la nostra implementazione open source di questa logica, che si trova nella Libreria dei componenti estesi.

Panoramica del flusso di lavoro

La tabella seguente riassume due azioni per il tuo sistema:

1. Il flusso di lavoro da utilizzare in base al comportamento di correzione, conferma e accettazione.
2. I primi indicatori da verificare dalla risposta. Indicatori descritti qui provengono dalla proprietà verdict e non sono l'unico indicatori da controllare, ma forniscono un indicatore iniziale dell'indirizzo qualità. Ogni tipo di comportamento corrisponde a una sezione di questo documento descrivendo ulteriori segnali che potresti dover indagare.

Linee guida per l'implementazione

Durante la progettazione del modo in cui il sistema reagisce agli indicatori dell'API Address Validation, i seguenti consigli possono aiutarti a creare una risposta più efficace un modello di machine learning. Tuttavia, si tratta solo di consigli, quindi tieni presente che dovrebbe essere adatta al tuo modello di business.

Correggere un indirizzo

Correggi un indirizzo quando i risultati indicano chiaramente che non è il prodotto finale. Il sistema può quindi chiedere al cliente di fornire i dati informazioni, dopodiché emetti il flusso di lavoro per ottenere .

Correggi indicatori

L'API Address Validation fornisce una serie di indicatori che ti consentono di sapere se un di destinazione deve essere corretto.

1. Granularità della convalida e componenti mancanti

Questi due segnali forniscono la migliore indicazione di un indirizzo problematico:

• Ogni volta che il campo validationGranularity è OTHER, il sistema deve analizza gli indicatori dei componenti dell'indirizzo per scoprire dove si trova l'errore e come correggerlo.
• Ogni volta che l'oggetto address post-elaborato restituisce un missingComponentTypes, il sistema deve verificare questo componente. Inoltre, l'assenza di componenti rendono un indirizzo incompleto e non recapitabile.

2. Altri indicatori

L'API Address Validation fornisce anche gli altri indicatori per diagnosticare problemi specifici:

3. Indicatori per gli indirizzi negli Stati Uniti

Alcuni campi applicabili solo agli indirizzi USA forniscono un indicatore utile del fatto che non è idoneo per la consegna e deve essere corretto. Per un indirizzo che richiede corretto, dovresti vedere quanto segue:

Per maggiori dettagli su dpvConfirmation, vedi Gestire gli indirizzi degli Stati Uniti.

Correggere esempi di indirizzi

Conferma un indirizzo

Confermi un indirizzo quando l'esito indica che l'API Address Validation dedotto o apportato modifiche ai componenti per produrre un valido. In questi casi, hai un indirizzo di consegna, ma preferisci con maggiore sicurezza che l'indirizzo risultante sia quello previsto al cliente.

Per fornire al cliente i prompt corretti, la tua logica identificherà i componenti segnalati dal servizio per determinare quale azione o segnalare l'API applicata al componente, come inferred, replaced o spellCorrected. Vedi AddressComponent nel riferimento.

Conferma indicatori

L'API Address Validation fornisce una serie di indicatori che ti consentono di sapere se un dell'indirizzo email deve essere confermato.

1. Granularità della convalida

Un valore validationGranularity di ROUTE o superiore è accettabile, ma PREMISE o SUBPREMISE fornisce un segnale più forte della possibilità di recapito.

2. Altri indicatori

Quando si decide di confermare l'inserimento dell'indirizzo con il cliente, l'esito anche fornisce quanto segue per stabilire quali componenti esaminare:

3. Indicatori per gli indirizzi negli Stati Uniti

Alcuni campi applicabili solo agli indirizzi negli Stati Uniti indicano che la logica deve verificare i dettagli con il cliente. Si applica una delle seguenti condizioni:

Esempi di verifica dell'indirizzo

Accetta un indirizzo

Accetti un indirizzo quando l'esito dà un elevato grado di certezza che L'indirizzo deve essere fornito e può essere utilizzato senza ulteriori interazioni con il cliente nel processo downstream.

Accetta indicatori

L'API Address Validation fornisce una serie di indicatori che ti consentono di sapere se un dell'indirizzo email deve essere confermato.

1. Granularità della convalida

Un valore validationGranularity pari o superiore a PREMISE è accettabile, ma in alcune casi, ROUTE indica comunque un indirizzo di consegna.

2. Altri indicatori

Un esito relativo a un indirizzo di alta qualità dovrebbe anche fornire quanto segue:

• Nessun dato sostituito. In questo caso, hasReplacedComponents: FALSE.
• Nessun componente dedotto. In questo caso, hasInferredComponents: FALSE.

3. Indicatori per gli indirizzi negli Stati Uniti

Alcuni campi applicabili solo agli indirizzi negli Stati Uniti indicano un indirizzo di alta qualità a cui è possibile recapitarli. Per un indirizzo statunitense accettabile, dovresti vedere il seguenti:

Accettare esempi di indirizzi