---
title: 소개
slug: api-guide/ko/_oeKTZsydb6adcDKFAJ6_
docTags: 
createdAt: 2024-12-16T13:32:41.000Z
---

그라운드 트루스 제작 프로세스에 프로그래밍 방식으로 접근할 수 있도록 HTTP API가 제공됩니다. 이 페이지에서는 이러한 통합 기능을 사용하는 방법, 어떤 기능들을 사용할 수 있는지, 그리고 사용되는 개념과 식별자에 대해 설명합니다.

현재는 전달된 어노테이션을 검토하는 기능만 지원됩니다.

## 사전 요구 사항

시작하기 전에 다음 사항을 확인하세요.

- API를 사용할 수 있는 권한이 있는 계정
- 생성된 API 자격 증명. [고급 설정](docId\:PN7g44HOAl8gvbqpgAgqF)을 참고하세요.
- 인증을 위한 Python 3 SDK 설치 - [kognic-auth](https://pypi.org/project/kognic-auth/)

또한 이 페이지에서는 다음을 전제로 합니다.

- 사용자는 입력 배치가 하나 이상 업로드된 프로젝트 중 최소 하나에 접근할 수 있습니다.

## API 클라이언트

[kognic-io Python 클라이언트](https://pypi.org/project/kognic-io/)는 대부분의 엔드포인트를 지원합니다. 지원되지 않는 경우를 위해, kognic-auth와 requests 라이브러리만으로 API와 상호 작용하는 방법에 대한 예제를 제공합니다.

## 엔드포인트

접근 가능한 엔드포인트 목록은 [swagger 문서](https://annotation-integration.app.kognic.com/api)에서 확인할 수 있습니다.

## 요청 예제

다음은 kognic-auth 라이브러리를 사용하여 사용자가 이용할 수 있는 [검토](docId:5rhBlRdM5gQrgtu9CeuNB)을 가져오는 예제입니다.

```python
import requests

from kognic.auth.requests.auth_session import RequestsAuthSession

base_url = "https://annotation-integration.app.kognic.com/v1/"
client = RequestsAuthSession()

try:
    response = client.session.get(base_url + "reviews/error-types")
    response.raise_for_status()
    data = response.json()
    print(data)
except requests.exceptions.RequestException as e:
    print(f"Request error: {e}")
```