Lingara API 라이브러리
이 페이지는 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 페이지가 정확합니다. 영어 페이지 읽기
Lingara API 라이브러리는 레퍼런스에서 설명하는 것과 같은 API를, 이미 사용하고 있는 언어로 호출합니다. 모든 라이브러리가 같은 명세에서 생성되고 같은 계약을 지키므로, 하나에서 배운 내용은 다른 라이브러리에도 그대로 적용됩니다.
- 인증. 클라이언트 ID와 시크릿을 클라이언트에 한 번만 전달하면 됩니다. 클라이언트는 이를 액세스 토큰으로 교환해 캐시하고, 만료 직전에 갱신하며, API가 401로 응답하면 새 토큰으로 호출을 한 번 재시도합니다.
- 스트림. 어휘 생성처럼 스트리밍하는 작업의 결과는 해당 언어 고유의 이터레이터로 전달됩니다. 라이브러리가 이벤트를 파싱하고, 스트림이 끝나면 반복을 종료합니다.
- 오류. 모든 실패는 공통 기본 타입을 공유하는 네 가지 오류 중 하나이므로, 하나의 핸들러로 모두 잡을 수 있습니다.
- 재시도. 얼마나 기다려야 하는지 알려 주는 429 또는 503은 한도 내에서 자동으로 재시도됩니다. 그 밖의 경우는 즉시 발생합니다.
이 페이지의 모든 코드 샘플은 라이브러리의 릴리스 버전에서 가져온 것으로, 배포 전에 컴파일되고 테스트됩니다.
설치
아래에서 언어를 선택하세요. 언어마다 첫 호출을 보여 주는 전용 페이지가 있으며, 라이브러리 사용하기 아래의 페이지에서 각 동작을 더 자세히 설명합니다.
TypeScript
npm install @lingara/api@0.1.0-alpha.6Rust
cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-threadGo
go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6Java
<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.6PHP
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 라이브러리.