Dilisense DB를 활용한 요주의인물 여부 확인(Watchlist Filtering) API 문서
테스트 API key를 발급 받은 후에 위 doc 링크의 Swagger API tool을 통해서 손쉽게 테스트 해보실 수 있습니다. </aside>
Swagger(API test tool)를 이용한 테스트
-
key 입력
-
Authorize클릭 후 세일즈팀을 통해서 발급받은 API key를 입력
-
-
Try it out클릭 후에 Request body 수정 -
Execute로 API 테스트
Request Body
{
"data": [
{
"name": "Donald Trumph",
"type": "person",
"fuzzyness": 1,
"dob": "14/06/1946",
"gender": "male"
}
],
"download": false
}
| Field | Type | Description |
|---|---|---|
| name***** | string | The name of the individual or entity to search for. The name can be a full name, a first name, a last name, a company name, etc. The name can also be a partial name, |
| e.g. "John" or "Smith". | ||
| type***** | string | The type of the search. Possible values are |
person - For searching for individuals. (개인) entity - For searching for entities. (법인) | | fuzzyness [optional] | number | This parameter defines if spelling differences need to be considered for the search string.
1: Fuzzy search with distance 1 (e.g. “business” will also match for “busines”) for the "names" parameter.
2: Fuzzy search with distance 2 (e.g. “business” will also match for “bisines”) for the "names" parameter. | | dob [optional] | string | dd/mm/yyyy if the exact date is known (e.g. 01/05/1990). 00/00/yyyy if only the year is known (e.g. 00/00/1990). 00/mm/yyyy if only the month and the year are known (e.g. 00/05/1990). dd/00/yyyy if only the day and the year are known (e.g. 01/00/1990). | | gender [optional] | string | The gender of the individual to search for. Possible values are
male - For searching only for individuals that are “male”. female - For searching only for individuals that are “female”. |
*required
- Dilisense API는 해당 요주의 인물의 한글/영문 이름으로 모두 검색 가능합니다. 영문을 보다 권장합니다.
- Dilisense API는 해당 요주의 인물의 생년월일(date of birth, dob), fuzzyness [optional]한 정보입니다. 없어도 검색이 가능합니다. 하지만 생년월일이 정확하면 보다 확실하게 검색이 됩니다.
- fuzzyness : 1 또는 2까지 설정이 가능함
- 1: Fuzzy search with distance 1 = 스펠링 1개 차이 (e.g. “business” will also match for “busines”) for the "name" parameter.
- 2: Fuzzy search with distance 1 = 스펠링 2개 차이 (e.g. “business” will also match for “busines”) for the "name" parameter.
- fuzzyness 설정을 하지 않는 경우 = 스펠링이나 한글 이름이 정확히 기입된 경우만 검색됨
Response Body
{
"result": [
{
"trxid": "654f497bf66315d26766072fc3b6d78648f14e25a040c6e4",
"name": "문제인",
"type": "person",
"gender": "male",
"fuzzyness": 1,
"pep": 1, // 정치인 (politically exposed person)
"sanctions": 0, // 제재 국가의 국민이거나 개인이 금융 제재 인물인 경우
"criminal": 0, // 범죄인
"other": 0,
"message": "success",
"details": [
{
"gender": "MALE",
"date_of_birth": "24/01/1953",
"political_parties": "Democratic Party of Korea",
"description": "12th President of South Korea",
"given_names": "Jae-in",
"occupations": "bookseller; lawyer; politician",
"spouse": "Kim Jung-sook",
"alias_names": "문재인; 文在寅",
"children": "Moon Da-hye; Moon Joon-yong",
"links": "Facebook: moonbyun1",
"last_names": "Mun",
"citizenship": "KR",
"source_type": "PEP",
"positions": "2012-05-30 - 2016-05-29 Member of the National Assembly of South Korea; 2007-03-12 - 2008-02-24 Chief of Staff to the President of South Korea; 2017-05-10 - 2022-05-09 President of South Korea",
"list_date": "0",
"place_of_birth": "Geoje",
"entity_type": "INDIVIDUAL",
"pep_type": "POLITICIAN",
"name": "Timothy Moon",
"parents": "Kang Han-ok; Moon Yong-hyung"
}
]
}
]
}
Error code
| Status code | Type | Description |
|---|---|---|
| 400 | Bad Request | type must be one of the following values: person, entity |
| (type은 반드시 선택해야 함, 개인(person) 또는 법인(entity)) | ||
| 400 | Bad Request | Unexpected string in JSON at position 94 (json 포멧 에러) |
| 400 | Bad Request | name should not be empty (이름은 필수 파라미터임) |