Bu dokümanda, ABD'ye özgü adres doğrulaması ele alınmaktadır:
- İş akışınızda USPS verilerini kullanma
- USPS teslimat noktası doğrulaması alanları (dpv)
- Güvenlik mesajları
İş akışınızdaki USPS verileri
Adres Doğrulama API hizmeti, ABD'deki adresleri doğrularken döndürülen değerin uspsData bölümünü de doldurabilir.
Bu nesne her zaman doldurulmadığı için adresleri doğrulamak için tek yöntem olarak bu mülke güvenmemeli, bunun yerine karar ve adres bileşenlerini de sisteminize dahil etmelisiniz.
USPS Delivery Point Verification (DPV)
uspsData
yanıtının bir parçası olarak dpvConfirmation
alanı tek bir değer döndürür
karakteriyle (USPS'in verilen adrese teslimat yapıp yapamayacağını bildirirsiniz).
Bu alanı aşağıdakileri belirlemek için kullanabilirsiniz:
- adres geçerliliği.
- Adreste alt tesis numarası eksikse.
- alt tesis numarası USPS veri sisteminde yoksa.
Hizmet, dört dpvConfirmation
değerinden birini döndürür veya hiç dpvConfirmation
değeri döndürmez. Aşağıdaki tabloda, mantığınızın 5 olası sonucun her biri için kullanması gereken önerilen davranış gösterilmektedir. Bu mantıkla ilgili daha fazla bilgi için Doğrulama yanıtını kullanma başlıklı makalenin İş akışına genel bakış bölümüne bakın.
Değer |
Davranış |
Açıklama |
---|---|---|
N veya boş |
Adresi düzeltme |
Adres, DPV onayı almadı. Bu, USPS'nin girilen sokakta (rota) bulunan tesis numarasını tanımadığı ve buraya teslimat yapamadığı anlamına gelir. |
D |
Adresi düzeltin |
Adres yalnızca birincil numara için DPV onaylıdır ve
ikincil numara bilgileri eksikti. |
S |
Adresi onaylayın |
Adres yalnızca birincil numara için DPV onaylıdır ve ikincil numara bilgisi vardı ancak onaylanmadı. Bu, girilen bina numarasının girilen rotada olduğu anlamına gelir. ama sağlanan alt binaya göre o binanın içinde yer almıyordur. USPS'ye gönderiliyor. |
Y |
Adresi kabul etme |
Adres, birincil ve ikincil numaralar için DPV onayı aldı. Bu, adresin, ABD Servis Sağlayıcı Sürümü dahil olmak üzere, tamamen USPS tarafından teslim edilebildiği anlamına gelir. alt bina numarası (varsa). |
Bu bölümün geri kalanında, DPV kodlarının kullanıldığı gerçek dünya senaryoları ele alınmaktadır.
DPV N örneği - adresi düzeltme
Bu örnekte, geçerli olmayan bir adreste var olmayan sokak numarası kullanılmaktadır.
- Girilen adres: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- Bölge: ABD
dpvConfirmation
alanı şu sonucu döndürür:N
Bu, tesis numarasının mevcut olmadığını gösteren son derece güçlü bir sinyal bu rotada. Diğer sorunlu adreslerde olduğu gibi, sisteminiz kullanıcıdan düzeltme yapmasını ister.
DPV D örneği - adresi düzeltme
Bu örnekte New York'taki Google ofisi kullanılmıştır ancak adresin zorunlu bir parçası olan alt tesis belirtilmemiştir. Bunu görmek için demoda yer alan adrese alt bina bilgisi eklemeyin.
- Adres girildi: 111 8th Avenue, New York, NY, 10011
- Bölge: ABD
dpvConfirmation
alanı şunu döndürür:D
Bu, girişte alt önermenin eksik olduğunu doğrular. Y için DPV'ye ulaşmak amacıyla girişe geçerli bir alt tesis eklenmelidir. Örneğin, Y değerini dpvConfirmation
elde etmek için FL 4 (4. Kat) geçerli bir alt tesisi dahil edebilirsiniz.
DPV S örneği - adresi onaylama
Bu örnekte, bina içinde bulunmayan bir alt bina numarası kullanılmaktadır:
- Girilen adres: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- Bölge: ABD
dpvConfirmation
alanı şunu döndürür:S
Bu, 1600 Amphitheatre Parkway adresine kayıtlı bir adres olarak ancak posta kabul edebiliyorsa, alt bina adresi Ste 101, adresin geçerli bir bölümü değildir. Sisteminiz bu bilgiyi kullanıcıyla doğrulamalı ve size düzeltme fırsatı bulur.
DPV Y örneği - adresi kabul edin
Bu örnekte, Mountain View, Kaliforniya'daki Googleplex adresi bir bilinen kaliteli bir adrestir.
- Girilen adres: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- Bölge: ABD
dpvConfirmation
alanı şu sonucu döndürür:Y
Adres tamamen USPS tarafından teslim edilebilir. Bu size yüksek derecede API'nın yüksek kalitede bir adres döndürdüğünden emin olamaz ve bu adresi sağlandığından emin olun.
Not: DPV, Address Validation API'nin girişte yazım düzeltmesi gibi herhangi bir değişiklik yapıp yapmadığını belirtmez.
ABD adresleri için güvenlik mesajları
Bu bölümde, yapay olarak oluşturulan adresler için USPS verilerinde sağlanan güvenlik işaretleri ele alınmaktadır. Bu güvenlik önlemi, gönderilen bir adresin yapay olarak oluşturulduğunu ve yasal olarak elde edilmediğini tespit ederek adres listesinin yapay olarak oluşturulmasını önlemek için tasarlanmıştır. Bu çok nadir görülür.
USPS yapay olarak oluşturulmuş bir adres tespit ettiğinde errorMessage
yanıtın uspsData özelliğinin alanında bir
hata mesajı gösteriliyor. Örneğin:
AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.