레시피
이 페이지는 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 페이지가 정확합니다. 영어 페이지 읽기
레시피는 여러분이 하려는 일의 이름이 붙은 연결입니다. 앱 및 연결의 “연결 만들기” 아래에서 “만들기 시작”을 누른 다음 하나를 고릅니다. 그러면 마법사가 단계를 하나씩 보여 주며, 각 단계는 이동할 때마다 저장되므로 중간에 나갔다가 다시 돌아올 수 있습니다. 앱에 보이지 않는 레시피는 아직 여러분의 계정에서 사용할 수 없습니다.
모든 레시피는 같은 두 단계, “확인”과 “적용”으로 끝납니다. 이 두 단계는 테스트, 시험 실행, 적용에서 설명합니다.
내 서버가 Lingara를 호출하도록 허용
서버가 자체 로그인 정보와 비밀번호를 받아, 여러분을 대신해 Lingara를 사용할 수 있게 됩니다.
- 만드는 것: 서버의 로그인 정보(OAuth 클라이언트)와 해당 로그인 정보의 비밀번호(클라이언트 시크릿).
- 단계: “이름 및 권한”, “확인”, “적용”.
- 그다음: 서버는 그 로그인 정보와 비밀번호로 로그인한 다음, “할 수 있는 작업”에서 부여한 권한으로 Lingara를 호출합니다.
로그인 정보 단계에 쓸 수 있는 선택적 스크립트입니다. 입력한 이름을 유지하고 서버용임을 표시합니다.
return lingara.client({ name: input.name + ' (server)', scopes: input.scopes })
레슨 플랜이 준비되면 내 서버에 알리기
레슨 플랜이 하나 준비될 때마다 Lingara가 서버에 메시지를 보냅니다.
- 만드는 것: 서버의 로그인 정보, 해당 로그인 정보의 비밀번호, 서버로 보내는 메시지(웹훅 엔드포인트).
- 단계: “이름 및 권한”, “보낼 곳”, “확인”, “적용”.
- 그다음: 서버는
lesson_plan.ready를 여러분이 입력한https://주소로 받습니다. 각 메시지에는 서명이 있습니다. 적용 후 표시되는 비밀번호 중 하나는 메시지가 정말 Lingara에서 왔는지 서버가 확인할 때 쓰는 것입니다.
“보낼 곳” 단계에 쓸 수 있는 선택적 스크립트입니다. 레슨 플랜을 만들 수 없었을 때 보내는 메시지도 함께 요청합니다.
return lingara.webhook({ client: input.client, url: input.url, events: [...input.events, 'lesson_plan.failed'] })
Lingara 안에 카드 표시
앱이 홈 또는 레슨 플랜 페이지에 카드를 그립니다.
- 만드는 것: 서버의 로그인 정보와 Lingara 안의 카드(앱 매니페스트).
- 단계: “이름 및 권한”, “내 카드”, “확인”, “적용”.
- 그다음: Lingara는 “앱이 카드를 그리는 위치”에 입력한 주소로 카드를 요청하고, 앱은 카드로 응답합니다. 적용 후 표시되는 비밀번호 중 하나는 요청이 정말 Lingara에서 왔는지 앱이 확인할 때 쓰는 것입니다.
“내 카드” 단계에 쓸 수 있는 선택적 스크립트입니다. 카드를 홈 페이지의 사이드 열에만 표시합니다.
return lingara.app({ client: input.client, manifest: lingara.manifest({ ...input.manifest, slots: ['home.side'] }) })