고객이 입력하는 동안 전체 주소를 제안하려면 locationSuggest를, 주소를 확인하고 표준화된 형식으로 돌려받으려면 locationValidate를 사용하세요. 주소 검증에 성공하면 그 결과를 partyCreate 또는 partyCreateWorkflow에 전달하여 해당 주소를 검증된 주소로 기록할 수 있습니다.
가지고 있는 주소 정보를 최대한 많이 전송하세요. 우편번호, 또는 locality와 administrative area를 함께 보내면 가장 좋은 결과를 얻을 수 있습니다.
검증 상태
상태↕
의미↕
권장 다음 단계↕
VERIFIED
건물 또는 정확한 호실 단위까지 주소가 검증되었습니다.
표준화된 주소를 사용하세요.
PARTIALLY_VERIFIED
도로나 도시 등 주소의 일부만 검증되었으며, 건물은 검증되지 않았습니다.
고객에게 건물 번호나 호실 번호 등의 세부 정보를 확인하도록 요청하세요.
UNVERIFIED
주소를 검증할 수 없습니다. address는 null입니다.
고객에게 주소를 확인하도록 요청하세요.
표준화된 주소
주소가 VERIFIED 또는 PARTIALLY_VERIFIED이면 address에 표준화된 형식의 주소가 담깁니다. 이 주소는 전송한 내용과 다를 수 있습니다. 도시 등 누락된 정보가 채워지거나, 우편번호가 완성되거나, 대소문자와 약어가 수정될 수 있습니다. 표준화된 주소를 고객에게 보여주거나, 고객이 입력한 주소 대신 사용하세요.
latitude와 longitude는 사용 가능한 경우 포함됩니다.
propertyType은 주소가 검증되고 유형을 알 수 있는 경우 RESIDENTIAL 또는 COMMERCIAL이며, 그 외에는 null입니다. 이 값은 자동으로 적용되지 않습니다. 사용하려면 party를 생성할 때 location 입력에 전달하세요.
VERIFIED 결과에는 verificationToken이 포함됩니다. 이 토큰을 locationValidate가 반환한 표준화된 주소 그대로와 함께 partyCreate 또는 partyCreateWorkflow의 location 입력에 전달하세요. 그러면 주소를 다시 확인하지 않고도 party의 location이 검증된 것으로 기록됩니다.
1mutationPartyCreate($input: PartyCreateInput!){
2 partyCreate(input:$input) {
3 id
4 type
5 location {
6 id
7 line1
8 locality
9 administrativeAreaCode
10 postalCode
11 countryCode
12 propertyType
13}
14}
15}
토큰을 전달할 때는 다음 규칙을 유의하세요.
토큰은 하루 동안 유효합니다. 만료된 토큰은 무시되며, party는 그대로 생성됩니다.
주소 필드는 표준화된 주소와 일치해야 합니다. 고객이 검증 후 주소를 수정하면 토큰은 무시되고 party는 그대로 생성됩니다. 새 토큰을 받으려면 수정된 주소를 검증하세요.
latitude, longitude, propertyType, metadata는 토큰에 영향을 주지 않고 변경할 수 있습니다.
토큰은 불투명한 값으로 취급하세요. 파싱하거나 변경하지 마세요. 변경된 토큰이나 다른 조직에 발급된 토큰은 요청을 실패시킵니다.
주소 제안 및 검증
주소 제안 및 검증
고객이 입력하는 동안 주소를 완성하고, 배송 전에 주소를 확인하세요.
GraphQL
고객이 입력하는 동안 전체 주소를 제안하려면
locationSuggest를, 주소를 확인하고 표준화된 형식으로 돌려받으려면locationValidate를 사용하세요. 주소 검증에 성공하면 그 결과를partyCreate또는partyCreateWorkflow에 전달하여 해당 주소를 검증된 주소로 기록할 수 있습니다.고객이 입력하는 동안 주소 제안하기
고객이 입력한 일부 주소와 검색할 국가를 전송하세요.
locationSuggest는 일치하는 전체 주소를partyCreate의 location 입력과 동일한 형태로 반환하므로, 고객이 선택한 주소로 주소 양식의 나머지 항목을 채울 수 있습니다.query LocationSuggest($input: LocationSuggestInput!) {locationSuggest(input: $input) {line1line2localityadministrativeAreaadministrativeAreaCodepostalCodecountryCodelatitudelongitude}}제안 입력 필드
countryCodelimitquery22382 Avenida Emp).제안은 출발점일 뿐, 검증된 주소가 아닙니다. 고객이 최종적으로 입력한 주소로 party를 생성하기 전에 해당 주소를 검증하세요.
주소 검증하기
전체 주소를
locationValidate로 전송하세요. 주소가 어느 수준까지 검증되었는지, 표준화된 형식의 주소, 그리고 주소가 검증된 경우verificationToken을 반환합니다.query LocationValidate($input: LocationValidateInput!) {locationValidate(input: $input) {statusverificationTokenaddress {line1line2localityadministrativeAreaadministrativeAreaCodepostalCodecountryCodelatitudelongitudepropertyType}}}검증 입력 필드
administrativeAreaadministrativeAreaCodeCA).countryCodeline1line2–line4localitypostalCode가지고 있는 주소 정보를 최대한 많이 전송하세요. 우편번호, 또는 locality와 administrative area를 함께 보내면 가장 좋은 결과를 얻을 수 있습니다.
검증 상태
VERIFIEDPARTIALLY_VERIFIEDUNVERIFIEDaddress는null입니다.표준화된 주소
주소가
VERIFIED또는PARTIALLY_VERIFIED이면address에 표준화된 형식의 주소가 담깁니다. 이 주소는 전송한 내용과 다를 수 있습니다. 도시 등 누락된 정보가 채워지거나, 우편번호가 완성되거나, 대소문자와 약어가 수정될 수 있습니다. 표준화된 주소를 고객에게 보여주거나, 고객이 입력한 주소 대신 사용하세요.latitude와longitude는 사용 가능한 경우 포함됩니다.propertyType은 주소가 검증되고 유형을 알 수 있는 경우RESIDENTIAL또는COMMERCIAL이며, 그 외에는null입니다. 이 값은 자동으로 적용되지 않습니다. 사용하려면 party를 생성할 때 location 입력에 전달하세요.party에 검증된 주소 기록하기
VERIFIED결과에는verificationToken이 포함됩니다. 이 토큰을locationValidate가 반환한 표준화된 주소 그대로와 함께partyCreate또는partyCreateWorkflow의location입력에 전달하세요. 그러면 주소를 다시 확인하지 않고도 party의 location이 검증된 것으로 기록됩니다.mutation PartyCreate($input: PartyCreateInput!) {partyCreate(input: $input) {idtypelocation {idline1localityadministrativeAreaCodepostalCodecountryCodepropertyType}}}토큰을 전달할 때는 다음 규칙을 유의하세요.
latitude,longitude,propertyType,metadata는 토큰에 영향을 주지 않고 변경할 수 있습니다.오류
Address verification is unavailableInvalid location verification tokenverificationToken이 변경되었거나 다른 조직에 발급된 토큰입니다.locationValidate가 반환한 토큰을 그대로 전달하거나, 생략하세요.limit must be between 1 and 20locationSuggest에 전달된limit이 허용 범위를 벗어났습니다.limit을 전달하거나, 생략하여 10개의 제안을 받으세요.LocationSuggestInput LocationValidateInput PartyCreateInput PartyCreateWorkflowInput
partyCreate partyCreateWorkflow
이 페이지가 도움이 되었나요?