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'deki adresleri doğrularken Address Validation API hizmeti dönüşün uspsData bölümünü de doldurabilir.
Bu nesne her zaman doldurulmadığından, özelliğini kullanmak yerine bileşenlerine ekleyin.
USPS Teslimat Noktası Doğrulaması (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:
- 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 veya
bir dpvConfirmation
değeri döndürmez. Aşağıdaki tabloda önerilen
her 5 olası sonucun her biri için mantığınızın kullanması gereken bir davranıştır. Daha fazla
daha fazla bilgi için
Doğrulama yanıtını kullanma konusundaki iş akışına genel bakış.
Değer |
Davranış |
Açıklama |
---|---|---|
N veya boş |
Adresi düzeltin |
Adres DPV onaylanmadı. Bu, USPS'nin girilen tesis numarasını tanımadığı anlamına gelir. girilen caddede (rotada) mevcut ve oraya teslim edilemiyor. |
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 edin |
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 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, 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 düzeltmelerini isteyesiniz.
DPV D örneği - adresi düzeltme
Bu örnekte Google'ın New York ofisi kullanılmaktadır ancak herhangi bir emin olun. 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ı şu sonucu döndürür:D
Bu, girişte alt önermenin eksik olduğunu doğrular. DPV'ye ulaşmak için
Y'de geçerli bir alt önerme, girişe dahil edilmelidir. Örneğin,
lisans almak için FL 4'ün (4. Kat) geçerli bir alt
dpvConfirmation
değeri (Y).
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 adresine kayıtlı bir adres olarak ancak posta kabul edebiliyorsa, alt bina adı 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.
- 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 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 (Adres Doğrulama API'si) herhangi bir yazım düzeltme gibi bir girişte değişiklik yapma.
ABD adresleri için güvenlik mesajları
Bu bölümde, şunlar için USPS verilerinde sağlanan güvenlik işaretleri ele alınmaktadır: yapay olarak oluşturulmuş adresler Bu güvenlik önlemi, gönderilen bir adresin ne zaman gönderildiğini tespit ederek yapay bir adres listesi oluşturma yapay olarak inşa edildiği ve meşru şekilde elde edilmemiş olduğu anlaşılmaktadı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.