وثائق API لوكيل التحليل العميق

v1 · مصادقة أساسية + دفع التفريغ + قراءة التحليل

المصادقة

تتطلب جميع واجهات /api/v1/* تمرير مفتاح API في ترويسة الطلب:

Authorization: Bearer lj_live_xxxxxxxxxxxxxxxx

يُنشأ مفتاح API في /settings/api-keys.

POST /api/v1/transcripts

دفع النص المُفرَّغ (مناسب: الأجهزة، وويب هوك أدوات التسجيل من طرف ثالث)

الطلب

curl -X POST https://lengjing.zaowuyun.com/api/v1/transcripts \
  -H "Authorization: Bearer lj_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "说话人1: ...\n说话人2: ...",
    "title": "周三战略会议",
    "device_id": "meeting-room-shanghai-01"
  }'

الاستجابة

{
  "transcript_id": "550e8400-e29b-41d4-a716-446655440000",
  "analysis_id": null,
  "message": "转写已保存"
}

GET /api/v1/analyses

سرد أحدث تحليلات المؤسسة (50 سجلًا)

curl https://lengjing.zaowuyun.com/api/v1/analyses \
  -H "Authorization: Bearer lj_live_xxxxxxxx"

GET /api/v1/analyses?id=xxx

جلب تفاصيل التحليل (مع مراسي الأدلة)

curl "https://lengjing.zaowuyun.com/api/v1/analyses?id=ANALYSIS_ID" \
  -H "Authorization: Bearer lj_live_xxxxxxxx"

تحديد المعدل

60 طلبًا في الدقيقة / مفتاح API (عند التجاوز تُرجع 429)

الصلاحيات (scopes)

• transcript.write — دفع التفريغ
• analysis.read — قراءة التحليل
• * — الكل

رموز الأخطاء

الدعم

للإبلاغ عن المشكلات:hi@zaowuyun.com