romanization
    • PDF

    romanization

    • PDF

    기사 요약

    개요

    한국 인명을 로마자 표기로 변환해 주는 REST API입니다. 비인증 기반 API 이므로 요청 URL에 검색어를 UTF-8로 인코딩하여 query 요청 변수에 포함해 주시고, GET으로 호출할 때 HTTP Header에 애플리케이션 등록시 발급 받은 Client ID와 Client Secret 값을 같이 전송해 주시면 활용 가능합니다.

    요청

    curl "https://naveropenapi.apigw.ntruss.com/krdict/v1/romanization?query=%EA%B9%80%EC%A0%95%ED%99%98" \
        -H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id 값}" \
        -H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret 값}" -v
    

    요청 파라미터

    요청 변수명타입필수 여부기본값설명
    querystringY-로마자로 바꾸려는 한글 이름

    요청 헤더

    헤더명설명
    X-NCP-APIGW-API-KEY-ID앱 등록 시 발급받은 Client ID
    X-NCP-APIGW-API-KEY-ID:{Client ID}
    X-NCP-APIGW-API-KEY앱 등록 시 발급 받은 Client Secret
    X-NCP-APIGW-API-KEY:{Client Secret}

    요청 바디

    • 해당 API 는 요청 바디를 필요로 하지 않습니다.

    응답

    응답 바디

    필드타입설명
    sFirstNamestring성에 대한 유니코드 값
    aItemsobject[]로마자 이름 배열
    aItems[].namestring변환된 로마자 이름
    aItems[].scorestring빈도수 정수값 배열

    예시

    요청 예시

    curl "https://naveropenapi.apigw.ntruss.com/krdict/v1/romanization?query=%EA%B9%80%EC%A0%95%ED%99%98" \
        -H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id 값}" \
        -H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret 값}" -v
    
    > GET /v1/krdict/romanization?query=%EA%B9%80%EC%A0%95%ED%99%98 HTTP/1.1
    > Host: naveropenapi.apigw.ntruss.com
    > User-Agent: curl/7.49.1
    > Accept: */*
    > X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id 값}
    > X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret 값}
    >
    

    응답 예시

    < HTTP/1.1 200 OK
    < Server: nginx
    < Date: Wed, 28 Sep 2016 06:54:30 GMT
    < Content-Type: application/json;charset=utf-8
    < Content-Length: 271
    < Connection: keep-alive
    < Keep-Alive: timeout=5
    < Vary: Accept-Encoding
    <
    * Connection #0 to host naveropenapi.apigw.ntruss.com left intact
    {
        "aResult":[
            {
                "sFirstName":"\uae40","aItems":[
                    {"name":"Kim Junghwan","score":"99"},
                    {"name":"Kim Jeonghwan","score":"70"},
                    {"name":"Kim Jungwhan","score":"39"},
                    {"name":"Kim Jeongwhan","score":"27"},
                    {"name":"Kim Jenghwan","score":"21"},
                    {"name":"Kim Jengwhan","score":"8"}
                ]
            }
        ]
    }
    

    오류 코드

    HttpStatusCodeErrorCodeErrorMessageSolution
    400400Incorrect query request (잘못된 쿼리요청)필수요청변수가 잘못되었거나 누락됨
    401024Authentication failed. (인증에 실패)클라이언트아이디와 시크릿값이 정확한지 확인 바람
    401024Scope Status Invalid API 권한을 체크했는지 확인 바람
    403072HTTPS only allowed : Unsupported protocol (지원하지 않는 프로토콜)API URL을 https로 수정 바람
    404051API does not exist. (존재하지 않는 API입니다.)API URL 이 정확한지 확인 바람

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.