romanization
    • PDF

    romanization

    • PDF

    Article Summary

    概要

    韓国の人名をローマ字表記に変換するREST APIです。非認証基盤APIであるため、検索語をUTF-8でエンコーディングしてリクエストURLの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. (認証に失敗しました。)client IDとsecret値が正しいかを確認してください。
    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.