Lingara Lingara 문서 학습 가이드 API 라이브러리 앱 만들기 웹 앱
언어: 한국어

Lingara API 라이브러리

이 페이지는 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 페이지가 정확합니다. 영어 페이지 읽기

Lingara API 라이브러리는 레퍼런스에서 설명하는 것과 같은 API를, 이미 사용하고 있는 언어로 호출합니다. 모든 라이브러리가 같은 명세에서 생성되고 같은 계약을 지키므로, 하나에서 배운 내용은 다른 라이브러리에도 그대로 적용됩니다.

  • 인증. 클라이언트 ID와 시크릿을 클라이언트에 한 번만 전달하면 됩니다. 클라이언트는 이를 액세스 토큰으로 교환해 캐시하고, 만료 직전에 갱신하며, API가 401로 응답하면 새 토큰으로 호출을 한 번 재시도합니다.
  • 스트림. 어휘 생성처럼 스트리밍하는 작업의 결과는 해당 언어 고유의 이터레이터로 전달됩니다. 라이브러리가 이벤트를 파싱하고, 스트림이 끝나면 반복을 종료합니다.
  • 오류. 모든 실패는 공통 기본 타입을 공유하는 네 가지 오류 중 하나이므로, 하나의 핸들러로 모두 잡을 수 있습니다.
  • 재시도. 얼마나 기다려야 하는지 알려 주는 429 또는 503은 한도 내에서 자동으로 재시도됩니다. 그 밖의 경우는 즉시 발생합니다.

이 페이지의 모든 코드 샘플은 라이브러리의 릴리스 버전에서 가져온 것으로, 배포 전에 컴파일되고 테스트됩니다.

설치

아래에서 언어를 선택하세요. 언어마다 첫 호출을 보여 주는 전용 페이지가 있으며, 라이브러리 사용하기 아래의 페이지에서 각 동작을 더 자세히 설명합니다.

TypeScript

npm install @lingara/api@0.1.0-alpha.6

Rust

cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-thread

Go

go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6

Java

<dependency>
  <groupId>com.getlingara</groupId>
  <artifactId>lingara-java</artifactId>
  <version>0.1.0-alpha.6</version>
</dependency>

Kotlin

implementation("com.getlingara:lingara-kotlin:0.1.0-alpha.6")

Ruby

gem install lingara -v 0.1.0-alpha.6

PHP

composer require spinningcatstudios/lingara:0.1.0-alpha.6

언어

  • TypeScript

    npm에 게시된 Node.js용 Lingara API 라이브러리.

  • Rust

    crates.io에 게시된 비동기 Rust용 Lingara API 라이브러리.

  • Go

    Go용 Lingara API 라이브러리. 표준 라이브러리 외에는 의존성이 없는 모듈입니다.

  • Java

    Maven Central에 게시된 Java 17 이상용 Lingara API 라이브러리.

  • Kotlin

    코루틴 기반으로 만든 JVM의 Kotlin용 Lingara API 라이브러리.

  • Ruby

    Ruby용 Lingara API 라이브러리. 런타임 의존성이 없는 gem입니다.

  • PHP

    Packagist에 게시된 PHP 8.2 이상용 Lingara API 라이브러리.

라이브러리 사용하기

  • 인증

    모든 라이브러리가 클라이언트 ID와 시크릿을 액세스 토큰으로 바꾸고, 토큰을 항상 새것으로 유지하는 방법.

  • 스트림

    라이브러리가 스트리밍 결과를 전달하는 방식과, 스트림이 끝나거나 실패하는 시점.

  • 오류와 재시도

    모든 라이브러리가 발생시키는 네 가지 오류와, 라이브러리가 자동으로 재시도하는 실패.