sharpapi laravel client

SharpAPI Laravel عميل SDK

أتمتة سير العمل باستخدام واجهة برمجة التطبيقات المدعومة بالذكاء الاصطناعي

استفد من AI API لتبسيط سير العمل في التجارة الإلكترونية والتسويق وإدارة المحتوى وتقنية الموارد البشرية والسفر والمزيد.

شاهد المزيد على موقع SharpAPI.com »

متطلبات

• بي إتش بي >= 8.1

• لارافيل >= 9.0

إذا كنت لا تستخدم Laravel، فيمكنك العثور على عميل SharpAPI PHP العام هنا »

تثبيت

اتبع هذه الخطوات لتثبيت وإعداد حزمة عميل SharpAPI Laravel.

1. تثبيت الحزمة عبر composer :

 يتطلب الملحن عميل Sharpapi/sharpapi-laravel

2. قم بالتسجيل في SharpAPI.com واحصل على مفتاح API.

3. قم بتعيين مفتاح API داخل .env

 SHARP_API_KEY=مفتاح

4. [اختياري] نشر ملف التكوين sharpapi-client.php .

ملاحظة: لم تعد بحاجة إلى نشر ملف التكوين لاستخدام هذه الحزمة. افتراضيًا، ستستخدم الحزمة قيمًا افتراضية معقولة. ما عليك سوى نشر التكوين إذا كنت ترغب في تخصيصه.

 بائع PHP الحرفي: نشر --tag=sharpapi-laravel-client

⛲ ماذا يمكن أن يفعل لك؟

• ؟ التجارة الإلكترونية

• قم بإنشاء مقدمات جذابة للمنتج بسرعة لجذب العملاء.

• قم بإنشاء رسائل بريد إلكتروني مخصصة لشكرك تلقائيًا لتحسين تجربة العملاء.

• تبسيط تصنيف المنتجات للحصول على كتالوج منظم جيدًا.

• تحليل المشاعر: فهم وتحليل المشاعر في مراجعات المنتجات لاتخاذ القرارات المستندة إلى البيانات.

• ️ أتمتة المحتوى والتسويق

• ترجمة النص بسهولة لجمهور عالمي.

• إعادة صياغة وتدقيق أي نص (بما في ذلك التدقيق النحوي)

• اكتشاف محتوى البريد العشوائي: تحديد محتوى البريد العشوائي وتصفيته بشكل فعال.

• استخراج معلومات الاتصال: استخراج أرقام الهواتف وعناوين البريد الإلكتروني من التنسيقات غير القياسية لتسهيل الاتصال.

• أنشئ ملخصات موجزة وكلمات رئيسية/علامات فريدة لتحسين استهلاك المحتوى.

• تعزيز جهود تحسين محركات البحث (SEO) عن طريق إنشاء علامات META تلقائيًا بناءً على المحتوى.

• تكنولوجيا الموارد البشرية

• قم بإنشاء أوصاف وظيفية معقدة دون عناء، مما يوفر الوقت في عملية التوظيف.

• المهارات والرؤى الوظيفية: تحديد المناصب الوظيفية والمهارات ذات الصلة لتبسيط عملية التوظيف.

• تحليل السيرة الذاتية الآلي: تحليل المعلومات واستخراجها بكفاءة من ملفات السيرة الذاتية لتسهيل المعالجة.

• ✈️

  السفر والسياحة والضيافة

• تحليل المشاعر في مراجعات السفر لتحسين الخدمات.

• تبسيط تصنيف الجولات والأنشطة ومنتجات الضيافة.

سمات

يرجى الرجوع إلى المسؤول:

• وثائق واجهة برمجة التطبيقات

• دعم متعدد اللغات : دعم 80 لغة لكل نقطة نهاية لواجهة برمجة تطبيقات تحليل المحتوى أو البيانات. تحقق من القائمة هنا.

• تنسيق RESTful سهل الاستخدام : مع مجموعة موحدة من نقاط النهاية - احصل على رؤى قيمة من خلال نقاط نهاية التحليل، وتغطية فئات المنتجات، والمهارات، والمناصب الوظيفية، وتوفير النتائج ذات الصلة.

• تنسيقات البيانات النظيفة نفسها دائمًا : كن مطمئنًا باستخدام تنسيق JSON المتسق والمتوقع لجميع البيانات التي يتم إرجاعها. لا داعي للقلق بشأن بيانات الذكاء الاصطناعي الغامضة.

• الدعم الفني : تم تصميمه بواسطة مطورين للمطورين، ونحن نقدم المساعدة المستمرة طوال رحلتك.

الاستخدام

يمكنك حقن فئة SharpApiService أو استخدام واجهة SharpApiService المفردة.

ننصحك باستخدام نظام قائمة الانتظار Laravel لتحسين المهام المرسلة وعملية التحقق من النتائج، خاصة إذا كنت تقوم بمعالجة دفعات أكبر من البيانات.

تتطلب حالة الاستخدام النموذجية الخطوات التالية:

1. أرسل إحدى طرق معالجة الذكاء الاصطناعي المتاحة (سيؤدي هذا إلى إرجاع عنوان URL لحالة معالجة المهمة)

2. قم بتشغيل طريقة fetchResults($statusUrl) التي تعمل في وضع الاستقصاء، حيث ترسل الطلبات أدناه كل 10 ثوانٍ لمدة 180 ثانية (يمكن تخصيص هذه القيم).

3. سيتم إرجاع كائن SharpApiJob .

4. بالنسبة لمهمة انتهت بحالة إرجاع success ، يمكنك الحصول على النتائج باستخدام إحدى الطرق، على سبيل المثال $jobResultJson = $jobResult->getResultJson() .

عادةً ما تستغرق كل مهمة مرسلة ما بين ثانيتين إلى دقيقة واحدة.

بعد تلك الفترة، عادةً ما تكون الوظيفة المرتجعة في حالة success وستكون نتائجها متاحة لمزيد من المعالجة. تقوم كل طريقة من طرق API بإرجاع تنسيق إرجاع مختلف. انتقل إلى قائمة طرق/نقاط النهاية لواجهة برمجة التطبيقات أدناه للحصول على التفاصيل»

تضمن واجهة برمجة التطبيقات الخاصة بنا إعادة التنسيق الصحيح في كل مرة. تميل محركات الذكاء الاصطناعي التي تستخدمها SharpAPI في حالات نادرة إلى سوء التصرف وانتهاء المهلة أو إرجاع بيانات غير صحيحة. وفي تلك الحالات، failed status الإرجاع للوظيفة. يمكنك إعادة تشغيل نفس طلب الوظيفة بالضبط في هذه الحالة.

وطالما أن المهمة لا تزال قيد المعالجة بواسطة محركنا، فإنها ستستمر في العودة إلى الحالة pending .

مثال لاستخدام وحدة التحكم

 <?phpnamespace AppHttpControllers;use GuzzleHttpExceptionGuzzleException;use SharpAPISharpApiServiceSharpApiService;الفئة SharpTest توسع وحدة التحكم {public function __construct(SharpApiService العامة $sharpApiService)
    {
    }/** * @throws GuzzleException */public function Detect_phones(): void{$statusUrl = $this->sharpApiService->detectPhones('أين تجدنا؟ اتصل بمستشار فني المبيعات: اتصل على: 7486-394-1800 أو مكتبنا في سنغافورة [phone]')؛        $result = $this->sharpApiService->fetchResults($statusUrl);        dd($result->getResultJson());/* تم إرجاعه: [ { "detected_number": "1800-394-7486"، "parsed_number": "[phone]" }، { "detected_number": "[phone]" , "parsed_number": "[phone]" } ] */
}

استثناءات غزيرة

يتم تسهيل طلبات HTTP الأساسية بواسطة Laravel HTTP Client/Guzzle، مما يجعل من المستحسن التعرف على استثناءات Guzzle الشائعة.

 استخدم GuzzleHttpExceptionClientException;// الخطوة 1: إرسال المهمة إلى واجهة برمجة التطبيقات باستخدام إحدى الطرق، على سبيل المثال:try {$statusUrl = SharpApiService::summarizeText($text, 'German', // Optional language500, // Optional length' نغمة صوت محايدة' // نغمة صوت اختيارية
      );// قيمة مثال $statusUrl: 'http://sharpapi.com/api/v1/job/status/75acb6dc-a975-4969-9ef1-c62cebc511cb'} Catch (ClientException $e) { $e->getResponse( )
}// الخطوة 2: طلب التحقق من حالة المهمة في وضع الاستقصاء وانتظار النتيجة$jobResult = SharpApiService::fetchResults($statusUrl);// الخطوة 3: الحصول على نتائج مهمة API المرسلة، مما يؤدي إلى إرجاع نتيجة الوظيفة كـ JSON$jobResultJson = $jobResult->getResultJson();// ..أو PHP array:$jobResultArray = $jobResult->getResultArray();// .. أو PHP stdClass:$jobResultObject = $jobResult->getResultObject();

تكوين مخصص اختياري

لذا يمكنك استبدال هذه القيم بإعدادات .env :

 SHARP_API_KEY=XXX_key_XXXSHARP_API_JOB_STATUS_POLLING_WAIT=200SHARP_API_JOB_STATUS_USE_POLLING_INTERVAL=trueSHARP_API_JOB_STATUS_POLLING_INTERVAL=5SHARP_API_BASE_URL=MOCK_SERVER

قائمة أساليب/نقاط النهاية API

تقوم كل طريقة دائمًا بإرجاع كائن SharpApiJob ، حيث ستعيد أساليب getResultJson / getResultArray / getResultObject بنية بيانات مختلفة. يرجى الرجوع إلى الأمثلة التفصيلية المتوفرة على SharpAPI.com

بالنسبة للطرق التي تحتوي على معلمات language ، يمكنك أيضًا استخدام قيم SharpApiLanguages ​​Enum لجعل التعليمات البرمجية الخاصة بك أكثر قابلية للقراءة.

الموارد البشرية

تحليل السيرة الذاتية/ملف السيرة الذاتية

يوزع ملف السيرة الذاتية (CV) من تنسيقات متعددة (PDF/DOC/DOCX/TXT/RTF) ويعيد كائنًا شاملاً من نقاط البيانات.

يمكن أيضًا توفير معلمة لغة إخراج اختيارية (يتم تعيين القيمة English كقيمة افتراضية).

 $statusUrl = SharpApiService::parseResume('/test/resume.pdf', 'English');

إنشاء الوصف الوظيفي

استنادًا إلى قائمة المعلمات الشاملة، توفر نقطة النهاية هذه تفاصيل مهمة موجزة في تنسيق الاستجابة، بما في ذلك الوصف المختصر ومتطلبات الوظيفة ومسؤوليات الوظيفة. المعلمة الإلزامية الوحيدة هي name .

تستخدم هذه الوظيفة معلمة فئة DTO ( Data Transfer Object ) تسمى JobDescriptionParameters للمساعدة في التحقق من صحة معلمات الإدخال. تعتبر معلمة name فقط في مُنشئ DTO هذا إلزامية.

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_tone. يمكن أن تكون صفات مثل funny أو joyous ، أو حتى اسم كاتب مشهور.

توفر طريقة API هذه أيضًا معلمة سياق اختيارية، والتي يمكن استخدامها لتوفير تعليمات مرنة إضافية لمعالجة المحتوى.

 $jobDescriptionParameters = جديد JobDescriptionParameters(
    الاسم: "مهندس PHP كبير"،
    اسم الشركة: "ACME LTD"، // الحد الأدنى الاختياري من الخبرة في العمل: "5 سنوات"، // الحد الأدنى الاختياري للتعليم: "درجة البكالوريوس"، // نوع التوظيف الاختياري: "دوام كامل"، // المهارات المطلوبة الاختيارية: ['PHP8'، 'Laravel']، // OptionalOptional_skills: ['AWS', 'Redis'], // Optionalcountry: "المملكة المتحدة"، // جهاز تحكم عن بعد اختياري: صحيح، // اختياريvisa_برعاية: صحيح، // صوت اختياري: "احترافي وغريب الأطوار"، // نغمة صوت اختيارية، سياق: null، // سياق اختياري، تعليمات معالجة الذكاء الاصطناعي الإضافية اللغة: null // لغة إخراج اختيارية
);$statusUrl = SharpApiService::generateJobDescription($jobDescriptionParameters);

المهارات ذات الصلة

يُنشئ قائمة بالمهارات ذات الصلة مع أوزانها كقيمة عائمة (1.0-10.0) حيث 10 تساوي 100%، وهي أعلى درجة صلة.

مطلوب المعلمة الأولى فقط ( name ).

يمكنك تحديد الإخراج باستخدام المعلمة max_quantity .

 $statusUrl = SharpApiService::dependentSkills('MySQL', 'English', // لغة اختيارية10 // كمية اختيارية
  );

المناصب الوظيفية ذات الصلة

يُنشئ قائمة بالمناصب الوظيفية ذات الصلة مع أوزانها كقيمة عائمة (1.0-10.0) حيث 10 تساوي 100%، وهي أعلى درجة صلة.

مطلوب المعلمة الأولى فقط ( name ).

يمكنك تحديد الإخراج باستخدام المعلمة max_quantity .

 $statusUrl = SharpApiService::dependentJobPositions('مهندس PHP كبير', 'الإنجليزية', // لغة اختيارية10 // كمية اختيارية
  );

التجارة الإلكترونية

مشاعر مراجعة المنتج

يحلل تقييم العميل للمنتج ويزوده بمشاعره (إيجابية/سلبية/محايدة) بدرجة تتراوح بين 0-100%. رائعة لمعالجة تقارير المشاعر لأي متجر عبر الإنترنت.

 $statusUrl = SharpApiService::productReviewSentiment('محتويات مراجعة العميل');

فئات المنتجات

يُنشئ قائمة بالفئات المناسبة للمنتج بأوزان ذات صلة كقيمة عائمة (1.0-10.0) حيث 10 تساوي 100%، وهي أعلى درجة صلة. قم بتوفير اسم المنتج ومعلماته للحصول على أفضل تطابقات ممكنة للفئة. يكون مفيدًا في تعبئة بيانات كتالوج المنتجات ومعالجة المنتجات بالجملة.

يمكنك تحديد الإخراج باستخدام المعلمة max_quantity .

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_tone . يمكن أن تكون صفات مثل funny أو joyous ، أو حتى اسم كاتب مشهور.

ضمن سياق معلمة اختيارية إضافية، يمكنك تقديم قائمة بالفئات الأخرى التي سيتم أخذها في الاعتبار أثناء عملية التعيين (على سبيل المثال فئات التجارة الإلكترونية الحالية).

 $statusUrl = SharpApiService::productCategories('Sony Playstation 5', 'الإنجليزية', // لغة اختيارية5, // الكمية الاختيارية'الذكاء التكنولوجي', // نغمة صوت اختيارية'Game Console, PS5 Console' // سياق اختياري, الفئات الحالية للمطابقة
  );

إنشاء مقدمة المنتج

يولد نسخة أقصر من وصف المنتج. قم بتوفير أكبر عدد ممكن من التفاصيل والمعلمات الخاصة بالمنتج للحصول على أفضل مقدمة تسويقية ممكنة. يكون مفيدًا في تعبئة بيانات كتالوج المنتجات ومعالجة المنتجات السائبة.

يمكنك تحديد الإخراج باستخدام المعلمة max_length . برجاء الأخذ في الاعتبار أن max_length يعد بمثابة اقتراح قوي لنموذج اللغة، وليس مطلبًا صارمًا، للحفاظ على المعنى العام للنتيجة.

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_tone . يمكن أن تكون صفات مثل funny أو joyous ، أو حتى اسم كاتب مشهور.

 $statusUrl = SharpApiService::generateProductIntro('Sony Playstation 5', SharpApiLanguages::ENGLISH, // لغة اختيارية300, // طول اختياري'Funny' // نغمة صوت اختيارية
  );

إنشاء بريد إلكتروني شكرًا لك

يُنشئ بريدًا إلكترونيًا مخصصًا لشكر العميل بعد الشراء. لا يحتوي محتوى الرد على العنوان أو الترحيب أو معلومات المرسل في النهاية، لذا يمكنك تخصيص بقية البريد الإلكتروني بسهولة.

يمكنك تحديد الإخراج باستخدام المعلمة max_length. برجاء الأخذ في الاعتبار أن max_length يعد بمثابة اقتراح قوي لنموذج اللغة، وليس مطلبًا صارمًا، للحفاظ على المعنى العام للنتيجة.

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_tone . يمكن أن تكون صفات مثل مضحك أو بهيج، أو حتى اسم كاتب مشهور.

توفر طريقة API هذه أيضًا معلمة سياق اختيارية، والتي يمكن استخدامها لتوفير تعليمات مرنة إضافية لمعالجة المحتوى.

 $statusUrl = SharpApiService::generatethanYouEmail('Sony Playstation 5', SharpApiLanguages::ENGLISH, // لغة اختيارية250, // طول اختياري'محايد', // نغمة صوت اختيارية'يجب دعوة العميل للزيارة مرة أخرى قبل العطلات' // اختياري سياق
   );

محتوى

ترجمة النص

يترجم النص المقدم إلى اللغة المحددة. ويدعم 80 لغة. يرجى التحقق من فئة Enum SharpApiLanguages ​​المضمنة للحصول على التفاصيل.

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_tone . يمكن أن تكون صفات مثل مضحك أو بهيج، أو حتى اسم كاتب مشهور.

تتوفر أيضًا معلمة context اختيارية. ويمكن استخدامه لتوفير المزيد من السياق للنص المترجم، مثل مثال حالة الاستخدام أو بعض التوضيحات الإضافية.

 $statusUrl = SharpApiService::translate('turn', SharpApiLanguages::FRENCH, // لغة اختيارية'محايدة', // نغمة صوت اختيارية "لقلب الصفحة" // سياق اختياري
    );// سينتج // {"content": "tourner", "to_language": "French", "from_language": "English"}

إعادة صياغة / إعادة صياغة

يولد نسخة معاد صياغتها من النص المقدم. مطلوب معلمة content فقط. يمكنك تحديد لغة الإخراج والحد الأقصى لطول الأحرف ونبرة الصوت.

يمكن توفير تعليمات إضافية حول كيفية معالجة النص في معلمة السياق. برجاء الأخذ في الاعتبار أن max_length يعد بمثابة اقتراح قوي لنموذج اللغة، وليس مطلبًا صارمًا، للحفاظ على المعنى العام للنتيجة.

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_tone اختيارية. يمكن أن تكون صفات مثل funny أو joyous ، أو حتى اسم كاتب مشهور.

توفر طريقة API هذه أيضًا معلمة context اختيارية، والتي يمكن استخدامها لتوفير تعليمات مرنة إضافية لمعالجة المحتوى.

 $statusUrl = SharpApiService::paraphrase($text, SharpApiLanguages::FRENCH, // لغة اختيارية 500, // الطول الاختياري "محايد"، // نغمة الصوت الاختيارية "تجنب استخدام الاختصارات" // سياق اختياري
    );

تدقيق النص + التدقيق النحوي

التدقيق اللغوي (والتحقق من القواعد النحوية) للنص المقدم.

 $statusUrl = SharpApiService::proofread($text);

كشف البريد العشوائي

يتحقق مما إذا كان المحتوى المقدم يجتاز اختبار تصفية البريد العشوائي. يوفر درجة ثقة مئوية وشرحًا لما إذا كان يعتبر بريدًا عشوائيًا أم لا. هذه المعلومات مفيدة للمشرفين لاتخاذ القرار النهائي.

 $statusUrl = SharpApiService::detectSpam($text);

كشف أرقام الهواتف

يوزع النص المقدم لأي أرقام هواتف ويعيد النسخة الأصلية المكتشفة وتنسيق E.164 الخاص بها. قد يكون مفيدًا في حالة معالجة أجزاء كبيرة من البيانات والتحقق من صحتها مقابل أرقام الهواتف أو إذا كنت تريد اكتشاف أرقام الهواتف في أماكن ليس من المفترض أن تكون فيها.

 $statusUrl = SharpApiService::detectPhones($text);

كشف رسائل البريد الإلكتروني

يوزع النص المقدم لأي رسائل البريد الإلكتروني المحتملة. قد يكون مفيدًا في حالة معالجة أجزاء كبيرة من البيانات والتحقق من صحتها مقابل عناوين البريد الإلكتروني أو إذا كنت تريد اكتشاف رسائل البريد الإلكتروني في أماكن ليس من المفترض أن تكون فيها.

 $statusUrl = SharpApiService::detectEmails($text);

توليد الكلمات الرئيسية/العلامات

يُنشئ قائمة بالكلمات الرئيسية/العلامات الفريدة بناءً على المحتوى المقدم.

يمكنك تحديد الإخراج باستخدام المعلمة max_quantity .

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_tone .

 $statusUrl = SharpApiService::generateKeywords($text, 'English', // لغة اختيارية5, // طول اختياري'Freaky & Curious', // نغمة صوتية اختيارية'add emojis!' // تعليمات سياق إضافية اختيارية لمعالجة المحتوى
  );

تلخيص النص

يولد نسخة مختصرة من المحتوى المقدم. مثالية لإنشاء مقدمات تسويقية لنصوص أطول.

يمكنك تحديد الإخراج باستخدام المعلمة max_length . برجاء الأخذ في الاعتبار أن max_length يعد بمثابة اقتراح قوي لنموذج اللغة، وليس مطلبًا صارمًا، للحفاظ على المعنى العام للنتيجة.

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_ton e. يمكن أن تكون صفات مثل funny أو joyous ، أو حتى اسم كاتب مشهور.

 $statusUrl = SharpApiService::summarizeText($text, 'English', // لغة اختيارية'David Attenborough', // نغمة صوتية اختيارية'add emojis!' // تعليمات سياق إضافية اختيارية لمعالجة المحتوى
  );

تحسين محركات البحث

إنشاء علامات SEO

يُنشئ جميع العلامات التعريفية الأكثر أهمية بناءً على المحتوى المقدم. تأكد من تضمين رابط لموقع الويب وعنوان URL للصور للحصول على أكبر عدد ممكن من العلامات.

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_ton e. يمكن أن تكون صفات مثل funny أو joyous ، أو حتى اسم كاتب مشهور.

 $statusUrl = SharpApiService::generateSeoTags($text, 'English', // لغة اختيارية'David Attenborough' // نغمة صوت اختيارية
  );

السفر والسياحة والضيافة

مشاعر مراجعة السفر

تحليل مراجعة منتج السفر/الضيافة وتقديم مشاعرها (إيجابية/سلبية/محايدة) بدرجة تتراوح بين 0-100%. رائعة لمعالجة تقارير المشاعر لأي متجر عبر الإنترنت.

 $statusUrl = SharpApiService::travelReviewSentiment($text);

جولات وأنشطة فئات المنتجات

يُنشئ قائمة بالفئات المناسبة لمنتج الجولات والأنشطة مع أوزان ذات صلة كقيمة عائمة (1.0-10.0) حيث 10 تساوي 100%، وهي أعلى درجة صلة. قم بتوفير اسم المنتج ومعلماته للحصول على أفضل تطابقات ممكنة للفئة. يكون مفيدًا في تعبئة بيانات كتالوج المنتجات ومعالجة المنتجات بالجملة. مطلوب فقط productName المعلمة الأولى.

يمكنك تحديد الإخراج باستخدام المعلمة max_quantity .

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_tone . يمكن أن تكون صفات مثل funny أو joyous ، أو حتى اسم كاتب مشهور.

ضمن context المعلمة الاختيارية الإضافية، يمكنك تقديم قائمة بالفئات الأخرى التي سيتم أخذها في الاعتبار أثناء عملية التعيين (على سبيل المثال فئات التجارة الإلكترونية الحالية).

 $statusUrl = SharpApiService::toursAndActivitiesProductCategories('واحة الخليج''ها لونج', // مدينة اختيارية'فيتنام', // بلد اختياري'انجليزي', // لغة اختيارية10, // كمية اختيارية'مغامر', // نغمة صوت اختيارية "Bay Hotels، Ha Long Hotels" // سياق اختياري، الفئات الحالية للمطابقة
    );

فئات منتجات الضيافة

يُنشئ قائمة بالفئات المناسبة لمنتج نوع الضيافة مع أوزان ذات صلة كقيمة عائمة (1.0-10.0) حيث 10 تساوي 100%، وهي أعلى درجة صلة. قم بتوفير اسم المنتج ومعلماته للحصول على أفضل تطابقات ممكنة للفئة. يكون مفيدًا في تعبئة بيانات كتالوجات المنتجات ومعالجة المنتجات السائبة. مطلوب فقط productName المعلمة الأولى.

يمكنك تحديد الإخراج باستخدام المعلمة max_quantity .

يمكنك ضبط أسلوب الكتابة المفضل لديك من خلال توفير معلمة voice_tone . يمكن أن تكون صفات مثل funny أو joyous ، أو حتى اسم كاتب مشهور.

ضمن context المعلمة الاختيارية الإضافية، يمكنك تقديم قائمة بالفئات الأخرى التي سيتم أخذها في الاعتبار أثناء عملية التعيين (على سبيل المثال فئات التجارة الإلكترونية الحالية).

 $statusUrl = SharpApiService::hospitalityProductCategories('فندق كريستال 大人専用''طوكيو', // مدينة اختيارية'اليابان', // بلد اختياري'انجليزي', // لغة اختيارية10, // كمية اختيارية'مغامر', // اختياري نغمة الصوت "فنادق طوكيو، فنادق كريستال" // سياق اختياري، الفئات الحالية للمطابقة
    );

نقاط النهاية الفنية لواجهة برمجة التطبيقات

معلومات الاشتراك / التحقق من الحصص

نقطة النهاية للتحقق من التفاصيل المتعلقة بالفترة الحالية للاشتراك

 $statusUrl = SharpApiService::quota();

سوف يؤدي إلى:

 " : "2024-03-18T12:37:39.000000Z"، "current_subscription_end": "2024-04-18T12:37:39.000000Z"، "subscription_words_quota": 100000، "subscription_words_used": 9608، "subscription_words_used_percentage": 0.1}

subscription_words_used_percentage هو نسبة مئوية من استخدام الحصة الشهرية الحالية وقد يكون بمثابة تنبيه للمستخدم بشأن الاعتمادات المستنفدة. إذا كانت القيمة أعلى من 80%، يُنصح بالاشتراك في المزيد من الاعتمادات على https://sharpapi.com/dashboard/credits لتجنب انقطاع الخدمة.

تتوفر هذه القيم أيضًا في لوحة المعلومات على https://sharpapi.com/dashboard

بينغ

نقطة نهاية PING بسيطة للتحقق من توفر واجهة برمجة التطبيقات ومنطقة التوقيت الداخلية الخاصة بها (الطابع الزمني).

 $statusUrl = SharpApiService::ping();

سوف يؤدي إلى:

 { "ping": "pong", "timestamp": "2024-03-12T08:50:11.188308Z"}

هل تعتقد أن واجهة برمجة التطبيقات لدينا تفتقد بعض الوظائف الواضحة؟

• يرجى إعلامنا عبر GitHub »

• أو انضم إلى مجموعة Telegram الخاصة بنا »

سجل التغيير

الرجاء مراجعة سجل التغيير للحصول على مزيد من المعلومات حول ما تغير مؤخرًا.

الاعتمادات

• ايه تو زد ويب المحدودة

• داود ماكوفسكي

• تعزيز قدرات Laravel AI الخاصة بك!

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا (MIT). يرجى الاطلاع على ملف الترخيص لمزيد من المعلومات.

وسائل التواصل الاجتماعي

للحصول على أحدث الأخبار والبرامج التعليمية ودراسات الحالة، لا تنس متابعتنا على:

• SharpAPI X (تويتر سابقًا)

• شارب أبي على يوتيوب

• شارب أبي فيميو

• شاربAPI ينكدين

• شارب أبي فيسبوك