api.hangulize.org

README

api.hangulize.org

Web API for Hangulize, powered by Google App Engine

API

You can find the actual API specification in openapi.yaml under OpenAPI Specification 3.0.1.

There was a former Hangulize Web API written in Python. That is considered as v1. The code still can be found at https://github.com/sublee/hangulize-web. The v1 API had complex content negotiation rules and not deterministic behaviors. v2 is re-designed against v1 to provide more simple and predictable usage.

GET /v2/version

Returns the version of the underlying Hangulize.

Content-Type	Result Example
text/plain	0.1.0
application/json	{"version": "0.1.0"}

GET /v2/specs

Provides the list of language-specific transcription specs.

Content-Type	Result Example
text/plain	ita jpn deu...
application/json	{"specs": [{"lang": {"id": "ita", "english": "Italian", ...}, ...]}

GET /v2/specs/{lang}.hgl

The source code of the spec. The only result format is text/vnd.hgl.

lang:
    id      = "ita"
    codes   = "it", "ita"
    english = "Italian"
    korean  = "이탈리아어"
    script  = "latin"

GET /v2/hangulized/{lang}/{word}

Transcribes a non-Korean word into Hangul. The result of GET /v2/hangulized/ita/cappuccino would be:

Content-Type	Result Example
text/plain	글로리아
application/json	{"lang": "ita", "word": "cappuccino", "transcribed": "카푸치노"}

GET /v2/phonemized/{phonemizer}/{word}

Guesses phonograms from a spelling. The result of GET /v2/phonemized/furigana/東京 would be:

Content-Type	Result Example
text/plain	トーキョー
application/json	{"phonemizer": "furigana", "word": "東京", "phonemized": "トーキョー"}

Development

To run locally, use Cloud SDK:

$ dev_appserver.py app.yaml

Or just build the main package:

$ go build && ./api.hangulize.org