الأسئلة الشائعة

كل ما تحتاج معرفته عن Pexafy. لم تجد إجابتك؟ تواصل معنا.

البدء والشروع

ما هو Pexafy؟

Pexafy هو محرك بحث عن الصور مدعوم بالذكاء الاصطناعي، يجمع ملايين الصور المجانية والمدفوعة من مصادر متعددة — Unsplash وPexels وPixabay وWikimedia Commons وغيرها — في واجهة برمجية واحدة (API). بدلاً من دمج عشرات خدمات الصور، تُرسل طلبًا واحدًا إلى Pexafy وتحصل على أفضل النتائج من جميع المصادر، مُرتَّبةً وفق الصلة الدلالية بالذكاء الاصطناعي.

كيف أحصل على مفتاح API؟

سجّل حسابًا مجانيًا على pexafy.com/auth/register/، ثم انتقل إلى لوحة التحكم ← مفاتيح API ← إنشاء مفتاح. يُنشأ مفتاحك الأول فورًا دون الحاجة إلى بطاقة ائتمانية. تتضمن الخطة المجانية 1K طلب API شهريًا.

هل Pexafy مجاني الاستخدام؟

نعم! تمنحك خطتنا المجانية 1K طلب API شهريًا — دون الحاجة إلى بطاقة ائتمانية. يمكنك البحث عبر الاستعلامات النصية والوصول إلى جميع مصادر الصور المجانية. هل تحتاج إلى مزيد من الطلبات، أو صور مميزة، أو بحث بالصور؟ تحقق من صفحة الأسعار لمعرفة خطط Pro والأعمال.

ما هي مصادر الصور التي يبحث فيها Pexafy؟

يجمع Pexafy حاليًا الصور من Unsplash وPexels وPixabay وWikimedia Commons وOpenverse. نحن نُضيف المزيد من المصادر باستمرار. يمكنك تصفية النتائج حسب المصدر باستخدام المعامل source في الـ API.

كيف يختلف Pexafy عن Google Images؟

Pexafy هو API موجَّه للمطورين أولًا، وليس محرك بحث استهلاكيًا. نجمع فقط المصادر المجانية الاستخدام والخاضعة لرخص Creative Commons، لذا فكل نتيجة آمنة للاستخدام في منتجك. يفهم نموذجنا الذكي المعنى الدلالي — ابحث عن "أجواء خريفية دافئة" واحصل على صور ذات صلة، لا مجرد تطابق في الكلمات المفتاحية. علاوة على ذلك، تحصل على استجابات JSON منظَّمة، وترقيم صفحات، وفلاتر، وتحليلات الاستخدام — كل ذلك عبر REST API واحد.

هل تقدّمون حزم SDK أو مكتبات عميل؟

نوفر حاليًا REST API مع توثيق شامل. حزم SDK الرسمية لـ Python وJavaScript/TypeScript وPHP مدرجة في خارطة الطريق. في غضون ذلك، يسهل دمج الـ API — مجرد طلب HTTPS واحد مع رأس مفتاح API. راجع توثيقنا للاطلاع على أمثلة الكود بعدة لغات.

الـ API والجوانب التقنية

ما هو حد معدل استخدام الـ API؟

تعتمد حدود المعدل على خطتك: المجانية — 20 طلب/دقيقة، Pro — 60 طلب/دقيقة، الأعمال — 300 طلب/دقيقة. إذا تجاوزت الحد، ستتلقى استجابة 429 Too Many Requests مع رأس Retry-After يُشير إلى وقت إعادة المحاولة.

ما هي الصيغ التي تُعيدها الـ API؟

جميع الاستجابات بصيغة JSON مع غلاف موحَّد: {success, data, meta, pagination, error}. يتضمن كل كائن صورة: id والعنوان والوصف والروابط (thumbnail وsmall وregular وfull وraw) والمصوّر (الاسم والرابط) والمصدر والرخصة والأبعاد والألوان ودرجة الصلة.

كيف أتعامل مع ترقيم الصفحات؟

يستخدم Pexafy ترقيم الصفحات المعتمد على المؤشر (cursor-based). تتضمن كل استجابة قيمة pagination.next_cursor. مرِّر هذه القيمة كمعامل cursor في طلبك التالي للحصول على الصفحة التالية. عندما تكون next_cursor فارغة (null)، فقد وصلت إلى النهاية.

هل يمكنني تصفية نتائج البحث؟

نعم! يمكنك التصفية حسب: color_name (red وblue وgreen…)، وcolor_hex (مثل #FF5733 مع color_tolerance الاختياري)، والاتجاه orientation (landscape وportrait وsquare)، والمصدر source (unsplash وpexels وpixabay…)، وscore_threshold (الحد الأدنى للصلة من 0.0 إلى 1.0). ادمج الفلاتر للحصول على نتائج دقيقة.

كيف أُصادق على طلبات الـ API؟

أضف مفتاح API كرأس في الطلب: X-Api-Key: pxfy_your_key_here. أو استخدم مصادقة Bearer token: Authorization: Bearer <jwt_token>. لا تشارك مفتاح API في كود جانب العميل مطلقًا.

ما هو الحد الأقصى لعدد النتائج لكل طلب؟

يمكنك طلب ما يصل إلى 80 نتيجة لكل صفحة باستخدام المعامل per_page (الافتراضي هو 20). بالنسبة لمجموعات النتائج الكبيرة، استخدم ترقيم الصفحات المستند إلى المؤشر لجلب الصفحات التالية. لا يوجد حد لإجمالي عدد الصفحات التي يمكنك تصفحها.

هل يدعم Pexafy استعلامات البحث متعددة اللغات؟

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

الفوترة والخطط

هل يمكنني تغيير خطتي؟

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

ماذا يحدث إذا تجاوزت حصتي؟

يتم حظر طلبات واجهة برمجة التطبيقات فور بلوغك الحد الشهري — ستتلقى استجابة 429 مع رسالة خطأ توضيحية. لمواصلة استخدام واجهة برمجة التطبيقات، قم بالترقية إلى خطة أعلى من لوحة التحكم ← الفوترة.

هل تقدمون استردادًا للمبالغ المدفوعة؟

نقدم ضمان استرداد المبالغ خلال 14 يومًا على جميع الخطط المدفوعة. إذا لم تكن راضيًا خلال أول 14 يومًا من الاشتراك، تواصل معنا على [email protected] وسنعيد إليك المبلغ كاملًا دون أي أسئلة.

ما طرق الدفع التي تقبلونها؟

نقبل جميع بطاقات الائتمان والخصم الرئيسية (Visa وMastercard وAmerican Express)، فضلًا عن Apple Pay وGoogle Pay — وتتم معالجة جميع المدفوعات بأمان عبر Stripe. نحن لا نخزن أي معلومات دفع على خوادمنا.

هل هناك عقد طويل الأمد؟

لا عقود ولا التزامات. جميع الخطط شهرية (أو سنوية بخصم إذا اخترت ذلك). يمكنك الإلغاء في أي وقت من لوحة التحكم ← الفوترة بنقرة واحدة. يستمر وصولك حتى نهاية فترة الفوترة الحالية.

هل يوجد خصم سنوي؟

نعم! الدفع السنوي يوفر لك ما يقارب 17%: خطة Pro بسعر $290/سنة ($24/شهر) بدلًا من $29/شهر. وخطة Business بسعر $2990/سنة ($249/شهر) بدلًا من $299/شهر. التحويل إلى الدفع السنوي متاح من لوحة التحكم ← الفوترة.

هل تقدمون خططًا مؤسسية مخصصة؟

نعم! إذا كانت احتياجاتك تتجاوز خطة Business — حدود معدل أعلى، أو بنية تحتية مخصصة، أو اتفاقية مستوى خدمة مخصصة، أو نشر محلي — تواصل معنا على [email protected] مع تفاصيل متطلباتك. وسنعدّ لك خطة مصممة خصيصًا لمنظمتك.

ما العملات التي تدعمونها للدفع؟

جميع الأسعار مُدرجة بالدولار الأمريكي (USD). يقوم Stripe، معالج الدفع لدينا، بالتحويل تلقائيًا إلى عملتك المحلية عند الدفع. قد يفرض بنكك رسومًا صغيرة على الصرف الأجنبي تبعًا لنوع بطاقتك وبلدك.

الصور والترخيص

هل يمتلك Pexafy الصور؟

لا. Pexafy محرك بحث — نقوم بفهرسة الصور والبحث فيها المستضافة على منصات خارجية (Unsplash وPexels وPixabay وغيرها). نحن لا نخزن ملفات الصور الفعلية ولا نستضيفها ولا نعيد توزيعها. تظل جميع الصور ملكًا لمصوريها ومنصاتها المعنية.

هل يمكنني استخدام الصور لأغراض تجارية؟

يعتمد ذلك على ترخيص المصدر. تتيح كل من Unsplash وPexels وPixabay تراخيص استخدام تجاري مجاني لمعظم صورها. أما Wikimedia Commons وOpenverse فتستخدمان تراخيص Creative Commons متنوعة — بعضها يتيح الاستخدام التجاري وبعضها لا يتيحه. احرص دائمًا على مراجعة حقل الترخيص في استجابة واجهة برمجة التطبيقات والتحقق من رابط المصدر قبل استخدام أي صورة لأغراض تجارية.

ما الفرق بين الصور المميزة والعادية؟

تظهر الصور المميزة في نتائج البحث، غير أنها قد تستلزم اشتراكاً أو شراءً من المصدر لتنزيلها بالدقة الكاملة. تُعيد واجهة برمجة التطبيقات (API) معاينات/صوراً مصغّرة لجميع الصور. في خططَي Free وPro، يُشير عنوان URL المصدر الوارد في الاستجابة إلى موضع الوصول للصورة كاملةً.

هل يمكنني تنزيل الصور عبر API؟

تُعيد Pexafy روابط URL للصور المستضافة على منصاتها الأصلية — ولا نُقدّم ملفات الصور مباشرةً عبر API. بالنسبة للصور المجانية (Unsplash وPexels وPixabay)، يمكنك تنزيل الصورة بالدقة الكاملة من عنوان URL المصدر المُدرج في الاستجابة. احرص دائماً على احترام شروط خدمة المنصة المصدر.

كم مرة يُحدَّث فهرس الصور؟

تعمل عملية الفهرسة لدينا يومياً لجميع المصادر الرئيسية. تصبح الصور الجديدة المُرفوعة على Unsplash وPexels وPixabay وغيرها من المنصات قابلةً للبحث عبر Pexafy في غضون 24 إلى 48 ساعة عادةً. يضمّ فهرسنا حالياً أكثر من 5 ملايين صورة ويتنامى يوماً بعد يوم.

الحساب والأمان

كيف أحذف حسابي؟

انتقل إلى Dashboard ← Settings ← Danger Zone ← Delete Account. حذف الحساب نهائي ولا رجعة فيه، وسيؤدي إلى إزالة جميع مفاتيح API وسجل الاستخدام والبيانات الشخصية الخاصة بك. يمكنك أيضاً مراسلتنا على [email protected] لطلب الحذف استناداً إلى GDPR/حق المحو.

هل بياناتي آمنة؟

نعم. نستخدم HTTPS في كل مكان، وbcrypt لتجزئة كلمات المرور، ونخزّن الجلسات في Redis مع رموز JWT قصيرة العمر. لا نبيع بياناتك ولا نشاركها مع أطراف ثالثة. تُجزَّأ مفاتيح API قبل تخزينها. اطّلع على سياسة الخصوصية للاطلاع على التفاصيل الكاملة حول ممارسات البيانات.

هل يمكنني امتلاك مفاتيح API متعددة؟

نعم، وذلك حسب خطتك: Free (1 مفتاح)، وPro (5 مفاتيح)، وBusiness (∞ مفاتيح). تتيح لك المفاتيح المتعددة تقسيم الاستخدام حسب التطبيق أو البيئة (dev/staging/prod) أو عضو الفريق، مع إمكانية إلغاء أي مفتاح بشكل منفرد دون التأثير على الآخرين.

ماذا يحدث إذا تعرّض مفتاح API الخاص بي للاختراق؟

أَلغِ على الفور المفتاح المخترق من Dashboard ← API Keys وأنشئ مفتاحاً جديداً. يسري الإلغاء فورياً — وسترفض أي طلبات تستخدم المفتاح القديم برمز خطأ 401. لا تحفظ مفاتيح API في نظام التحكم بالإصدارات قط؛ استخدم متغيرات البيئة عوضاً عن ذلك.

ما هو ضمان وقت التشغيل لديكم؟

نستهدف توفر واجهة برمجة التطبيقات (API) بنسبة 99.9 بالمئة من الوقت. يحصل عملاء خطة الأعمال على اتفاقية مستوى الخدمة (SLA) التي تتضمن التزامات بوقت التشغيل. يمكنك مراقبة حالة الخدمة في الوقت الفعلي والسجل التاريخي لها عبر صفحة الحالة لدينا، والتي يمكن الوصول إليها من تذييل هذا الموقع.

هل Pexafy متوافقة مع GDPR؟

نعم. نجمع الحد الأدنى من البيانات اللازمة لتشغيل الخدمة (البريد الإلكتروني وكلمة المرور المجزّأة وسجلات الاستخدام) فحسب. لا نبيع البيانات لأطراف ثالثة. يمكنك طلب تصدير بياناتك كاملةً أو حذفها في أي وقت من Dashboard ← Settings أو بمراسلتنا على [email protected]. راجع سياسة الخصوصية للاطلاع على التفاصيل الكاملة.

هل لا تزال لديك أسئلة؟

لم تجد ما تبحث عنه؟ يسعد فريقنا بمساعدتك.

تواصل مع الدعم اقرأ توثيق API

حول Pexafy المدوّنة