Bu dokümanda, Amerika Birleşik Devletleri'ne özel adres doğrulama konuları ele alınmaktadır:
- İş akışınızda USPS verilerini kullanma
- USPS Delivery Point Verification alanları (dpv)
- Güvenlik mesajları
İş akışınızdaki USPS verileri
ABD'de Adres Doğrulama API'si hizmeti, ABD'deki adresleri doğrularken iadenin uspsData bölümünü de doldurabilir.
Bu nesne her zaman doldurulmadığından, adresleri doğrulamak için tek yöntem olarak bu mülke güvenmemelisiniz. Bunun yerine, karar ve adres bileşenlerini sisteminize de dahil etmelisiniz.
USPS Teslimat Noktası Doğrulaması (DPV)
uspsData
yanıtının bir parçası olarak, dpvConfirmation
alanı USPS'nin sağlanan adrese teslimat yapıp yapamayacağını bildirmek için tek bir karakter döndürür.
Bu alanı aşağıdakileri belirlemek için kullanabilirsiniz:
- geçerlidir.
- Adreste alt bina numarası eksikse.
- alt tesis numarası USPS veri sisteminde yoksa.
Hizmet, dört dpvConfirmation
değerinden birini döndürür ya da hiç dpvConfirmation
değeri döndürmez. Aşağıdaki tabloda, 5 olası sonucun her biri için mantığınızın kullanması gereken önerilen davranış gösterilmektedir. Bu mantık hakkında daha fazla bilgi için Doğrulama yanıtını kullanma bölümündeki İş akışına genel bakış bölümüne bakın.
Değer |
Davranış |
Açıklama |
---|---|---|
N veya boş |
Adresi düzeltin |
Adres DPV onaylanmadı. Bu, USPS'nin girilen tesiste (rota) numarası tanımadığı ve oraya teslim edemeyeceği anlamına gelir. |
D |
Adresi düzeltin |
Adres yalnızca birincil numara için DPV onaylandı ve ikincil numara bilgileri eksikti. |
S |
Adresi onaylayın |
Adres yalnızca birincil numara için DPV onaylandı. İkincil numara bilgisi mevcuttu ancak onaylanmadı. Bu, girilen tesis numarasının girilen rotada olduğu ancak USPS'e göre sağlanan alt binanın bu bina içinde yer almadığı anlamına gelir. |
Y |
Adresi kabul edin |
Adres, birincil ve ikincil numaralar için DPV onayı aldı. Bu, adresin, alt tesis numarası da dahil olmak üzere, tamamen USPS tarafından teslim edilebildiği anlamına gelir. |
Bu bölümün geri kalanında, DPV kodlarının kullanıldığı gerçek 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.
- Adres girildi: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- Bölge: ABD
dpvConfirmation
alanı şu sonucu döndürür:N
Bu, söz konusu tesis numarasının bu rotada mevcut olmadığını gösteren son derece güçlü bir sinyaldir. Diğer sorunlu adreslerde olduğu gibi, sisteminiz kullanıcıdan düzeltme istemelidir.
DPV D örneği - adresi düzeltme
Bu örnekte Google'ın New York ofisi kullanılmaktadır ancak adresin zorunlu bir parçası olan bir alt bina yoktur. Bunu görmek için demoda yer alan, alt bina bilgileri olmadan belirtilen adresi kullanabilirsiniz.
- Adres girildi: 111 8th Avenue, New York, NY, 10011
- Bölge: ABD
dpvConfirmation
alanı şu sonucu döndürür:D
Bu, girişte alt önermenin eksik olduğunu doğrular. Y'nin DPV'sine ulaşmak için girişe geçerli bir alt önerme dahil edilmelidir. Örneğin, FL 4'ün (4. Kat) geçerli bir alt panosunu ekleyerek dpvConfirmation
değerini elde edebilirsiniz.
DPV S örneği - adresi onaylama
Bu örnekte, bina içinde bulunmayan bir alt bina numarası kullanılmaktadır:
- Adres girildi: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- Bölge: ABD
dpvConfirmation
alanı şu sonucu döndürür:S
Bu, 1600 Amphitheatre Parkway posta kabul edilebilen bir adres olarak mevcut olsa da, Ste 101 alt binasının adresin geçerli bir bölümü olmadığını göstermektedir. Sisteminiz bu bilgiyi kullanıcıyla onaylamalı ve düzeltme için bir fırsat sunmalıdır.
DPV Y örneği - adresi kabul edin
Bu örnekte, bilinen bir kalite adresi olarak Mountain View, Kaliforniya'daki Googleplex adresi kullanılmaktadır.
- Adres girildi: 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, API'nin iyi kalitede bir adres döndürdüğü konusunda size son derece güven verir ve bu adresi belirtildiği gibi kullanabilirsiniz.
Not: DPV, Address Validation API'nin girişte yazım düzeltme 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şturulmuş 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 meşru şekilde elde edilmemiş olduğunu tespit ederek adres listesinin yapay oluşturulmasını önlemek için tasarlanmıştır. Bu çok nadir görülür.
USPS yapay olarak oluşturulmuş bir adres belirlediğinde yanıtın uspsData özelliğinin errorMessage
alanı, sorunu açıklayan bir hata mesajı içerir. Ö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.