Công thức

Trang này được dịch từ tiếng Anh. Nếu hai bản khác nhau, trang tiếng Anh là bản đúng. Đọc trang tiếng Anh

Công thức là một kết nối được đặt tên theo việc bạn muốn làm. Bạn chọn một công thức trong Ứng dụng & kết nối, dưới “Tạo kết nối”, sau khi nhấn “Bắt đầu tạo”. Sau đó trình hướng dẫn hiển thị từng bước một, và mỗi bước được lưu khi bạn chuyển tiếp, nên bạn có thể rời đi rồi quay lại. Công thức nào ứng dụng không hiển thị cho bạn thì chưa khả dụng trên tài khoản của bạn.

Mọi công thức đều kết thúc bằng cùng hai bước, “Kiểm tra” và “Áp dụng”. Kiểm thử, chạy mô phỏng và áp dụng mô tả hai bước này.

Cho máy chủ của tôi gọi Lingara

Máy chủ của bạn có thông tin đăng nhập và mật khẩu riêng, để có thể dùng Lingara thay cho bạn.

• Tạo ra: thông tin đăng nhập cho máy chủ của bạn (Ứng dụng khách OAuth) và mật khẩu cho thông tin đăng nhập đó (Khóa bí mật của ứng dụng khách).
• Các bước: “Tên và quyền hạn”, “Kiểm tra”, “Áp dụng”.
• Sau đó: máy chủ của bạn đăng nhập bằng thông tin đăng nhập đó và mật khẩu của nó, rồi gọi Lingara với những quyền hạn bạn đã cấp trong “Những gì nó được phép làm”.

Một tập lệnh tùy chọn cho bước đăng nhập, giữ nguyên tên bạn đã nhập và đánh dấu nó là của máy chủ:

return lingara.client({ name: input.name + ' (server)', scopes: input.scopes })

Báo cho máy chủ của tôi khi một kế hoạch bài học đã sẵn sàng

Lingara gửi cho máy chủ của bạn một tin nhắn mỗi khi một kế hoạch bài học của bạn sẵn sàng.

• Tạo ra: thông tin đăng nhập cho máy chủ của bạn, mật khẩu cho thông tin đăng nhập đó, và tin nhắn gửi đến máy chủ của bạn (Điểm cuối webhook).
• Các bước: “Tên và quyền hạn”, “Gửi đến đâu”, “Kiểm tra”, “Áp dụng”.
• Sau đó: máy chủ của bạn nhận lesson_plan.ready tại địa chỉ https:// bạn đã cung cấp. Mỗi tin nhắn đều được ký: một trong các mật khẩu hiển thị sau khi áp dụng là mật khẩu máy chủ của bạn dùng để kiểm tra rằng tin nhắn thực sự đến từ Lingara.

Một tập lệnh tùy chọn cho bước “Gửi đến đâu”, yêu cầu thêm tin nhắn được gửi khi không thể tạo một kế hoạch bài học:

return lingara.webhook({ client: input.client, url: input.url, events: [...input.events, 'lesson_plan.failed'] })

Hiển thị thẻ bên trong Lingara

Ứng dụng của bạn vẽ một thẻ trên trang Trang chủ hoặc trang Kế hoạch bài học của bạn.

• Tạo ra: thông tin đăng nhập cho máy chủ của bạn, và một thẻ bên trong Lingara (Tệp kê khai ứng dụng).
• Các bước: “Tên và quyền hạn”, “Thẻ của bạn”, “Kiểm tra”, “Áp dụng”.
• Sau đó: Lingara yêu cầu thẻ từ địa chỉ bạn đã nhập trong “Nơi ứng dụng của bạn vẽ thẻ”, và ứng dụng của bạn trả lời bằng thẻ đó. Một trong các mật khẩu hiển thị sau khi áp dụng là mật khẩu ứng dụng của bạn dùng để kiểm tra rằng yêu cầu thực sự đến từ Lingara.

Một tập lệnh tùy chọn cho bước “Thẻ của bạn”, chỉ hiển thị thẻ ở cột bên của trang chủ:

return lingara.app({ client: input.client, manifest: lingara.manifest({ ...input.manifest, slots: ['home.side'] }) })