본문으로 건너뛰기

개발 환경

LINE Planet은 시험용(evaluation)과 실제 서비스용(real)의 2가지 환경을 제공합니다. 아래 표에서 보듯, 작업 환경에 따라 planet_base_url이 다르므로 반드시 올바른 값을 서버의 주소로 사용해야 합니다.

환경용도planet_base_url
Evaluation개발 단계나 PoC(Proof of Concept) 때 LINE Planet을 연동해 짧은 시간 안에 테스트할 수 있는 환경입니다.https://voipnx-saturn.line-apps-rc.com
Real서비스를 운영하거나 운영 서비스의 QA 단계처럼 실제 환경에서 테스트하고 싶을 때 사용합니다.https://voipnx-saturn.line-apps.com

API key와 LINE Planet 환경​

LINE Planet을 연동하기 전에 API key를 생성해야 합니다. API key를 생성하려면 아래 4가지 정보가 필요합니다.

항목정보필수
LINE Planet 환경Evaluation, real 중 사용할 환경필수
서비스 ID문자열 형식 서비스 식별자필수
애플리케이션 서버 콜백 URLLINE Planet 서버가 호출할 애플리케이션의 콜백 URL.
  • 1대1 통화 콜백
    • notify_cb: 통화가 이뤄졌을 때 호출될 콜백
    • on_call_evt_cb: 통화가 끊어졌을 때 호출될 콜백
  • 그룹 통화(컨퍼런스) 콜백
    • on_gcall_evt_cb: 참여자가 들어오거나 나갈 때 호출될 콜백
  • Agent Call Status 콜백(에이전트 통화 기능을 사용할 경우에만 필수)
    • agent_call_status_cb: 에이전트 통화 API 요청에서 성공적인 응답을 받은 경우 호출되며, 에이전트 통화 발신 성공 여부를 전달하는 콜백
각 콜백에 대한 자세한 정보는 서버 콜백을 참조하세요.		필수
웹 애플리케이션 도메인웹으로 개발한 애플리케이션의 도메인 주소. LINE Planet Cloud에서 CORS(Cross-Origin Resource Sharing) 정책에 따라 클라이언트의 출처(origin)를 허용하기 위해서는 웹 애플리케이션 도메인을 미리 알아야 합니다.선택 (WebPlanetKit을 사용할 때만)
Note

허용되는 서비스 ID 형식은 서비스 ID를 참고하세요.

예제​

여기서는 예제를 통해 작업 흐름을 알아봅니다. 애플리케이션을 개발, RC, 실제 서비스 환경으로 구성했다고 가정합시다. 이때, 주의할 것이 있습니다.

  • 환경마다 API key를 생성해야 합니다.
  • 올바른 API key와 planet_base_url 쌍을 사용해야 합니다.

1. API key 3개 생성​

다음처럼 개발, RC, 실 서비스용으로 API key를 총 3개 생성합니다.

애플리케이션 환경API key 생성 데이터생성한 API key
개발1 환경: Evaluation
2 서비스 ID: planet-ex-service-dev
3.1 notify_cb: http://dev.app.com/call/notify
3.2 on_call_evt_cb: http://dev.app.com/call/endevt
3.3 on_gcall_evt_cb: http://dev.app.com/call/gcall		API-EVAL-1
RC1 환경: Real
2 서비스 ID: planet-ex-service-rc
3.1 notify_cb: http://rc.app.com/call/notify
3.2 on_call_evt_cb: http://rc.app.com/call/endevt
3.3 on_gcall_evt_cb: http://rc.app.com/call/gcall		API-REAL-1
실제 서비스1 환경: Real
2 서비스 ID: planet-ex-service-real
3.1 notify_cb: http://real.app.com/call/notify
3.2 on_call_evt_cb: http://real.app.com/call/endevt
3.3 on_gcall_evt_cb: http://real.app.com/call/gcall		API-REAL-2

2. 클라이언트 설정: API key와 planet_base_url 쌍​

애플리케이션에서 PlanetKit SDK를 초기화할 때, 위에서 생성한 API key와 그에 맞는 planet_base_url 쌍을 사용해야 합니다. 예제에서는 각 환경에서 아래처럼 설정합니다.

애플리케이션 환경생성한 API keyplanet_base_url
개발API-EVAL-1Evaluation(https://voipnx-saturn.line-apps-rc.com)
RCAPI-REAL-1Real(https://voipnx-saturn.line-apps.com)
실제 서비스API-REAL-2Real(https://voipnx-saturn.line-apps.com)
Note

WebPlanetKit의 경우 환경별 라이브러리 파일이 다르기 때문에 초기화 과정에서 planet_base_url의 설정이 필요하지 않습니다.