빠른 시작

API 버전 2026-10-affable-towhee

아무것도 없는 상태에서 스트리밍되는 어휘 목록까지 다섯 단계입니다. 클라이언트를 만들고, 셸에 넣고, 액세스 토큰으로 교환하고, 한 번 호출하고, 토큰이 만료되면 새 토큰을 받으세요.

1. 클라이언트 만들기

Lingara 웹 앱의 연동 페이지(app.getlingara.com/admin)의 OAuth 클라이언트에서 어휘 생성(스코프 vocab:generate)을 할 수 있는 클라이언트를 만드세요. 클라이언트 ID와 시크릿을 복사하세요. 시크릿은 한 번만 표시됩니다.

2. 셸에 넣기

클라이언트 ID와 시크릿을 LINGARA_CLIENT_ID와 LINGARA_CLIENT_SECRET 환경 변수에 저장하세요. 그러면 명령어에 시크릿을 직접 쓰는 일이 없습니다.

export LINGARA_CLIENT_ID="<your client id>"
export LINGARA_CLIENT_SECRET="<your client secret>"

3. 액세스 토큰 받기

이 명령은 클라이언트를 액세스 토큰으로 교환해 LINGARA_TOKEN에 보관하며, 이 참조 문서의 모든 예제가 거기에서 토큰을 읽습니다. jq와 curl 7.76 이상이 필요합니다. 교환에 실패하면 명령은 오류 코드를 출력하고(예: invalid_client라면 ID와 시크릿을 확인하세요) LINGARA_TOKEN을 비워 두므로, 교환에 성공할 때까지 다음 호출은 401로 실패합니다. jq가 없다면 인증 가이드의 교환을 실행하고 응답에서 access_token을 직접 복사하세요.

export LINGARA_TOKEN="$(curl -sS --fail-with-body -X POST "https://api.getlingara.com/oauth/token" \
  -u "$LINGARA_CLIENT_ID:$LINGARA_CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  --data-urlencode "scope=vocab:generate" | jq -r '.access_token // error(.error)')"

4. 어휘 목록 생성하기

이 명령을 실행하세요. -N은 curl의 버퍼링을 끄므로 각 이벤트가 도착하는 대로 출력됩니다.

curl -N -X POST "https://api.getlingara.com/v1/vocab/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"level":2,"source_lang":"en","target_lang":"zh","count":8}'

예상 결과

목록 정보를 담은 started 이벤트, 단어마다 하나씩 item 이벤트, 그리고 done이 표시됩니다. 실제 단어는 이 예시와 다를 수 있습니다.

event: started
data: {"meta":{"level":2,"source_lang":"en","target_lang":"zh","framework":"HSK","count":2,"ai_generated":true}}

event: item
data: {"word":"你好","pronunciation":"nǐ hǎo","translation":"hello","example":{"sentence":"你好，我叫小明。","translation":"Hello, my name is Xiaoming."}}

event: item
data: {"word":"谢谢","pronunciation":"xiè xie","translation":"thank you"}

event: done
data: {}

5. 한 시간이 지나면

호출이 401로 응답합니다. 3단계를 다시 실행하세요. 이제 3단계가 실패한다면 연동 페이지에서 클라이언트나 그 시크릿이 바뀐 것입니다. 프로그램은 인증 가이드의 규칙을 따릅니다. 401마다 한 번 다시 교환하고, 교환이 실패하면 중단합니다.

번역본과 영어 참조 문서의 내용이 다른 경우, 영어 참조 문서가 올바른 것으로 봅니다.