romanization
- 印刷する
- PDF
romanization
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
概要
韓国の人名をローマ字表記に変換する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
リクエストパラメータ
リクエスト変数名 | タイプ | 必須 | 基本値 | 説明 |
---|---|---|---|---|
query | string | Y | - | ローマ字に変換しようとするハングル名前 |
リクエストヘッダ
ヘッダ名 | 説明 |
---|---|
X-NCP-APIGW-API-KEY-ID | アプリケーションを登録する時に発行されたClient IDX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | アプリケーションを登録する時に発行されたClient SecretX-NCP-APIGW-API-KEY:{Client Secret} |
リクエストボディ
- 該当APIはリクエストボディが必要ありません。
レスポンス
レスポンスボディ
フィールド | タイプ | 説明 |
---|---|---|
sFirstName | string | 氏に対するユニコード値 |
aItems | object[] | ローマ字の名前の配列 |
aItems[].name | string | 変換されたローマ字名前 |
aItems[].score | string | 頻度数の整数値配列 |
例示
リクエスト例示
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"}
]
}
]
}
エラーコード
HttpStatusCode | ErrorCode | ErrorMessage | Solution |
---|---|---|---|
400 | 400 | Incorrect query request (間違ったクエリリクエストです。) | 必要リクエスト変数が間違っているか漏れています。 |
401 | 024 | Authentication failed. (認証に失敗しました。) | client IDとsecret値が正しいかを確認してください。 |
401 | 024 | Scope Status Invalid API権限をチェックしたか確認してください。 | |
403 | 072 | HTTPS only allowed : Unsupported protocol (サポートされてないプロトコルです。) | API URLをhttpsに修正してください。 |
404 | 051 | API does not exist. (存在しないAPIです。) | API URLが正しいかを確認してください。 |
この記事は役に立ちましたか?