# Reference

Context API 연동 순서와 준비 사항, 상황별로 참고할 문서를 안내합니다.

Source: https://cue.airbridge.io/docs/ko/reference
Language: ko
Updated: 2026-10-15

서버나 CRM에서 Context API를 호출하면 앱 사용자별 설치 유입 정보와 구매 및 이탈 예측값을 받아 서비스에 활용할 수 있습니다. 연동에는 대상 앱의 CUE 사용 설정과 예측 데이터, 해당 앱의 토큰과 테스트 사용자 ID가 필요합니다.

## Context API 연동하기

아래 순서로 요청과 응답 처리를 구현할 수 있습니다.

1. [시작하기](/docs/ko/quickstart)에 따라 앱 설정을 확인하고 토큰과 테스트 사용자 ID를 준비합니다.
2. [Context API](/docs/ko/reference/context-api)의 Endpoint → Headers → Request body → Payload 예시 순서로 요청을 작성합니다.
3. 정상 응답에서 `appId`, `user`, `context.lastTouchpoint`와 구매 및 이탈 예측값을 확인합니다.
4. [오류 처리](/docs/ko/reference/errors)에 따라 오류나 시간 초과가 발생했을 때 실행할 기본 동작을 구현합니다.
5. 정상 응답, 서비스에서 정한 조건에 맞지 않는 응답과 조회 실패를 각각 테스트합니다. 각 상황에서 의도한 화면이나 메시지가 제공되는지도 확인합니다.

## 확인할 문서

연동 중 필요한 내용은 아래 문서에서 확인할 수 있습니다.

| 문서                                            | 확인할 내용                                                                                  |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [Context API](/docs/ko/reference/context-api)      | 식별자 3개 중 1개를 선택하는 방법, 전체 요청과 응답 예시, 필드 규격을 설명합니다.            |
| [오류 처리](/docs/ko/reference/errors)             | 오류 코드 12개의 원인과 처리 방법, 재시도 여부, 기본 동작과 문의에 필요한 정보를 설명합니다. |
| [예측값 활용하기](/docs/ko/guides/reading-predictions) | 구매와 이탈의 예측 기간, 확률과 등급의 의미를 설명합니다.                                    |
| [용어집](/docs/ko/glossary)                        | 토큰, 식별자 연결, JSON과 기본 동작의 뜻을 설명합니다.                                       |

## 문서와 명세의 기준

Context API의 정상 응답에는 `requestId`, `appId`, `user`, `context`, `predictions`가 포함됩니다. 전체 응답과 필드 규격은 [Context API](/docs/ko/reference/context-api)와 [OpenAPI 명세](/openapi.json)에서 확인할 수 있습니다.

`context.lastTouchpoint`는 설치에 기여한 광고 정보입니다. 반환된 광고 정보를 개인화에 활용하는 방법은 [설치 유입 정보 활용하기](/docs/ko/guides/install-touchpoint)에서 설명합니다. `predictions`의 구매 및 이탈 예측 기간, 확률과 등급의 의미는 [예측값 활용하기](/docs/ko/guides/reading-predictions)에서 확인할 수 있습니다.

이 문서를 읽는 에이전트는 [llms.txt](/llms.txt)에서 작업에 맞는 문서와 연동 시 주의점을 찾을 수 있습니다. 본문은 각 문서의 Markdown 원문으로, 요청과 응답 규격은 [OpenAPI 명세](/openapi.json)로 제공됩니다.