الخطوة 1. تقديم طلب وظيفة الذكاء الاصطناعي
نقطة النهاية: POST - /api/v1/tth/review_sentiment
| السمة |
النوع |
إلزامي |
الوصف |
| المحتوى |
String |
نعم |
تقديم نص المراجعة لتحليل الشعور. |
مثال الطلب:
{
"content": "لقد قضينا إقامة رائعة في جين أورشارد!! غرف وأسرة مريحة للغاية. بوفيه الإفطار اللذيذ والمتنوع يستحق التجربة أيضًا. المسبح رائع حقًا ويوفر مناظر مذهلة. لم نتمكن من الاستمتاع به كما كنا نريد بسبب العواصف الرعدية، لكن يمكنك حتى البقاء هنا إذا كان لديك رحلة متأخرة، وهو ما كان لدينا. تحتوي غرف تغيير الملابس على خزائن مجانية تناسب بسهولة أمتعة يدك وهناك دشات للانتعاش والتغيير قبل المغادرة إلى المطار. الموقع مثالي، فوق محطة MRT مباشرة. الموظفون ودودون للغاية. بالتأكيد سأبقى هنا مرة أخرى عند زيارتي لسنغافورة."
}
مثال الاستجابة:
{
"status_url": "https://sharpapi.com/api/v1/content/translate/job/status/5de4887a-0dfd-49b6-8edb-9280e468c210",
"job_id": "5de4887a-0dfd-49b6-8edb-9280e468c210"
}
الخطوة 2. مراقبة وجلب نتائج وظيفة الذكاء الاصطناعي
نقطة النهاية: GET - /api/v1/tth/review_sentiment/job/status/:uuid
تُستخدم نقطة النهاية للتحقق من تقدم وظيفة API المطلوبة.
مثال النتيجة:
{
"data": {
"type": "api_job_result",
"id": "065c36a4-56a8-4af0-bb2b-5a62ae67d404",
"attributes": {
"status": "success",
"type": "tth_review_sentiment",
"result": {
"opinion": "POSITIVE",
"score": 95,
"emotion": "delight",
"urgency": "none",
"topics": [
{
"topic": "room_comfort",
"sentiment": "positive",
"mention_count": 2
},
{
"topic": "breakfast_buffet",
"sentiment": "positive",
"mention_count": 1
},
{
"topic": "pool",
"sentiment": "positive",
"mention_count": 1
},
{
"topic": "location",
"sentiment": "positive",
"mention_count": 1
},
{
"topic": "staff_friendliness",
"sentiment": "positive",
"mention_count": 1
}
],
"loyalty_signal": "promoter",
"recommended_action": "highlight_positive",
"language": "en",
"travel_category": "accommodation"
}
}
}
}