공개 에이피아이

1. 소개

[쉬운 우리말 검색] 서비스를 2021년 10월 9일부터 공개 에이피아이(Open API)로 제공합니다.

[쉬운 우리말 검색]은 문화체육관광부가 후원하며, 사단법인 한글문화연대가 주관한 쉬운 우리말 쓰기 운동 사업에서 일반 시민과 국어 전문가, 시민운동가, 시인 등 각계각층의 의견을 바탕으로 한글문화연대가 개발하였습니다.

이 에이피아이는 공공언어에서 사용하는 여러 외국어를 쉬운 우리말로 바꾸어 쓰고 싶을 때 언제든지 간편하게 사용할 수 있게 도와줍니다. 쉬운 우리말 사전은 외국어를 대체할 우리말과 바꾸어 쓴 예문들, 여러 낱말 정보를 보여줍니다. 누리집 “쉬운 우리말을 쓰자”(https://www.plainkorean.kr)에서 이 쉬운 우리말 사전과 대화창 형태의 검색 프로그램(챗봇)을 적용하였고, 공개 에이피아이 사용 방법도 안내합니다.

공개 에이피아이의 사용은 무료이며, 오프라인에서 사용되는 형태의 응용프로그램(어플리케이션), 방화벽 등으로 외부 접속이 불가능한 환경에서도 사용할 수 있게 원본 정보자료를 사용하기 편리한 ‘제이에스오엔엘(JSONL)’ 형식으로도 함께 제공할 예정입니다.

2. 사용방법

* 공개 에이피아이 요청 주소: https://plainkorean.kr/api.jsp
* 쉬운 우리말 에이피아이 서비스 이용 안내

: 개발 표준을 위해 JSON 기반의 데이터를 제공합니다.

쉬운 우리말 에이피아이 서비스 이용 안내요청변수명, 형식, 필수 선택, 설명으로 구성된 쉬운 우리말 에이피아이 서비스 이용 안내하는 표
요청변수명 형식 필수 선택 설명
keyword string 필수 검색할 외국어, 어려운 공공언어
* 요청/응답 예제
  • 요청 : https://plainkorean.kr/api.jsp?keyword=게리멘더링
  • 응답(박스 처리 요망)
[
  {
"keyword": "게리맨더링",
"alt" : "자의적 선거구 획정",
"example": [
"국회가 자초한 게리맨더링이 논란이다.",
"특정 정당과 후보자에게 유리한 게리맨더링을 방지해야 한다.",
"우리나라는 법률로 선거구를 정해 게리맨더링을 금지하고 있다."
]
}...

]