لا يحتاج معظم المستخدمين إلى API Playground أصلًا، إذ تؤدي Search وFinder وVerify المهمة نفسها في شاشة أسهل.
استخدم Playground عندما تريد أن ترى ما سيحصل عليه المطوّر من Tomba. فواجهة API هي الوسيلة التي تتصل بها البرامج الأخرى بـ Tomba، ويتيح لك Playground تجربتها دون كتابة أي كود.
قبل أن تبدأ
افتح API Keys مرة واحدة على هذا الجهاز، لأن Playground يحتاج إلى مفتاحك ليعمل. إذا تخطيت هذه الخطوة، فستظهر لك الرسالة No API key on this device والزر Go to API Keys.
إجراء عملية بحث
الخطوة 1. افتح Playground، ضمن API > Playground.
الخطوة 2. اختر عملية بحث من القائمة Endpoint، مثل /email-finder. يظهر اسمها مع وصف موجز أسفل القائمة.
الخطوة 3. املأ الحقول. في حالة /email-finder، اكتب tomba.io في الحقل domain واسم الشخص في الحقل full_name. ويمكنك ترك الحقول المعلَّمة بأنها اختيارية فارغة.
الخطوة 4. انقر على Send request.
⚠️ مهم: يُجري هذا الإجراء بحثًا حقيقيًا ويستهلك أرصدة حقيقية، وتُحتسب تكلفته مثل أي عملية بحث أخرى.
ماذا تعني النتائج
تظهر الإجابة في لوحة الاستجابة، وهي ما سيحصل عليه برنامج المطوّر مقابل عملية البحث نفسها. وإذا فشلت عملية البحث، فستظهر لك Request failed مع السبب.
💳 الأرصدة: تظهر التكلفة بجوار Send request، مثل «Costs 1 finder credit». وأرصدة Finder هي نفسها أرصدة البحث لديك.
الأسئلة الشائعة
لماذا لا يمكنني النقر على Send request؟
أحد الحقول المطلوبة فارغ، ويذكر Playground اسم الحقل الناقص أسفل الزر.
لماذا لا أجد Reveal في القائمة؟
لا يشمل Playground الأداة Reveal. استخدم Reveal داخل التطبيق.
كيف يربط المطوّر البرامج بـ Tomba؟
يمكنه استخدام عميل API، وهو حزمة كود جاهزة تربط برنامجك بـ Tomba. وستجدها كلها في Libraries، ضمن API > Libraries. ولدينا أدلة لكل من Node.js وPHP وPython وRuby وGo وRust وDart وDeno وElixir وLua وPerl وR.
مقالات ذات صلة