Gửi sự kiện

Tham số

Lingara-Versionheaderstringtùy chọn

Phiên bản API dùng để trả lời yêu cầu này. Nếu không có, token truy cập nhận phiên bản mà ứng dụng khách của nó được gắn, còn yêu cầu không có token nhận phiên bản hiện tại. Phiên bản đang phát triển chỉ có thể dùng bằng cách nêu tên nó ở đây. Phiên bản không xác định được trả lời bằng 400 với mã api_version_unknown. GET /v1/versions liệt kê các phiên bản.

Idempotency-Keyheaderstringbắt buộc

Một giá trị bạn chọn cho mỗi sự kiện và dùng lại khi thử lại: 1 đến 255 ký tự ASCII hiển thị được, chẳng hạn một UUID. Lần thử lại với cùng khóa sẽ nhận lại câu trả lời đầu tiên và không bị tính phí lần nữa, kể cả khi nội dung khác. Nếu không có khóa hợp lệ, yêu cầu trả lời 400 với mã idempotency_key_required.

Nội dung yêu cầu application/json

typestringbắt buộc

dataWorldPracticeRequestedbắt buộc

topicstringbắt buộc

source_langstringbắt buộc

target_langstringbắt buộc

levelintegerbắt buộc

tagsarray of stringtùy chọn

generateboolean | nulltùy chọn

Phản hồi

202 Sự kiện đã được ghi lại

idstringbắt buộc

typestringbắt buộc

created_atstringbắt buộc

reactionReactionReport | nulltùy chọn

statusReactionStatusbắt buộc

plan_idstring | nulltùy chọn

plan_statusPlanStatus | nulltùy chọn

Trạng thái của kế hoạch khi sự kiện được chấp nhận. Chỉ generating hứa rằng lesson_plan.ready hoặc lesson_plan.failed sẽ đến. Mọi giá trị khác là kế hoạch lấy từ thư viện, bạn có thể đọc ngay bằng GET /v1/lesson-plans/{id}.

codestring | nulltùy chọn

errorstring | nulltùy chọn

Lỗi

402application/json

Lệnh gọi của một ứng dụng khách tính phí theo mức dùng đã bị từ chối trước khi tiêu bất cứ thứ gì. spend_cap_reached: ứng dụng khách hoặc tài khoản của nó đã chạm hạn mức chi tiêu hằng tháng; hãy nâng hạn mức trên trang Tích hợp. metered_billing_inactive: tính phí theo mức dùng chưa được kích hoạt cho tài khoản này; hãy thiết lập hoặc cập nhật phương thức thanh toán trên trang Tích hợp.

410application/json

Phiên bản API dùng để trả lời yêu cầu này đã bị ngừng. Hãy gửi một phiên bản được hỗ trợ trong Lingara-Version, hoặc gắn ứng dụng khách với một phiên bản khác.

4XXapplication/json

Yêu cầu đã bị từ chối. code cho biết lý do, và error diễn đạt lý do đó bằng lời.

503application/json · text/plain

Dịch vụ tạm thời không khả dụng; hãy thử lại sau số giây ghi trong Retry-After. Trong thời gian bảo trì, phần thân là văn bản thuần thay vì phong bì lỗi.

5XXapplication/json

Yêu cầu đã bị từ chối. code cho biết lý do, và error diễn đạt lý do đó bằng lời.

codestringbắt buộc

Lý do yêu cầu bị từ chối, dưới dạng một mã ổn định để rẽ nhánh: ví dụ insufficient_scope (403), rate_limited (429) và, với ứng dụng khách tính phí theo mức dùng, spend_cap_reached (402) và metered_billing_inactive (402).

errorstringbắt buộc

Ví dụ

curl -X POST "https://api.getlingara.com/v1/events" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"world.context_changed","data":{"scene":"A night market in Taipei, just after rain","npc":{"name":"Auntie Lin","persona":"a street-food vendor who likes to haggle"},"source_lang":"en","target_lang":"zh","level":3,"tags":["market","food","chapter-2"],"generate":true}}'

Muốn dùng thư viện? Xem mục Thư viện.