مفتاح API مجاني لبيئة اختبار إدراجات الأنشطة التجارية
اختبر API إدراجات الأنشطة التجارية وخادم MCP ببيئة اختبار بتصريح ليوم واحد مجاني (24 ساعة)، دون بطاقة ائتمان. حتى موقعين ومزامنة مع 10 أدلة تجريبية فقط.
احصل على مفتاح API مجاني لبيئة الاختبار، وجرّب به REST API لإدراجات الأنشطة التجارية من listingsAPI وخادم MCP المستضاف في تكامل تحسين محركات البحث المحلية لديك، دون بطاقة ائتمان. يسري التصريح ليوم واحد لمدة 24 ساعة من تفعيله، ويُتاح خلال فترات محدودة. يمكنك إنشاء ما يصل إلى موقعين وتحديثهما ومتابعة مزامنة إدراجات أنشطتهما التجارية مع 10 أدلة تجريبية من listingsAPI تحاكي MapQuest وApple Maps وBing وYelp وغيرها. لا يُرسَل أي شيء إلى منصات نشر حقيقية مطلقًا، لذا يمكنك تجربة دورة الإنشاء والمزامنة والتحديث كاملةً دون المساس بملف نشاط تجاري حقيقي.
الحالة المباشرة: GET /api/day-pass يوضح ما إذا كان التصريح ليوم واحد متاحًا الآن.
يُتاح التصريح ليوم واحد خلال فترات محدودة. وعندما يكون مغلقًا، يُرجع طلب التسجيل 403 مع sandbox_closed، ويظل بإمكانك البدء بخطة مدفوعة تتضمن فترة تجريبية مجانية مدتها 14 يومًا.
ما تحصل عليه
يتطلب كل تسجيل تقديم الاسم الأول واسم العائلة والبريد الإلكتروني والشركة، والموافقة على شروط الخدمة وسياسة الخصوصية. يستخدم الأشخاص ووكلاء الذكاء الاصطناعي التصريح ليوم واحد نفسه: يمكن للوكيل بدء التصريح نيابةً عن مستخدمه، ويثبت المستخدم ملكيته للبريد الإلكتروني.
تبدأ مدة الـ24 ساعة عند بدء التصريح: عندما يضغط صاحبه على Start my day pass (بدء تصريحي ليوم واحد) عبر الرابط المُرسَل بالبريد الإلكتروني، أو عند استخدام الرمز المكوّن من 6 أرقام المُرسَل بالبريد الإلكتروني. يظل الرابط والرمز صالحين لمدة 24 ساعة بعد التسجيل.
تختلف الفترة التجريبية المجانية البالغة 14 يومًا عن ذلك. فهي تعمل ضمن خطة مدفوعة مع وجود بطاقة مسجلة، وتتيح النشر إلى أدلة حقيقية. لا يحتاج التصريح ليوم واحد إلى بطاقة، ويسري ليوم واحد، ويتيح النشر إلى أدلة تجريبية فقط.
ابدأ التصريح من متصفحك
- افتح صفحة التسجيل للحصول على تصريح ليوم واحد وأدخل اسمك وبريدك الإلكتروني وشركتك، ثم وافق على شروط الخدمة وسياسة الخصوصية.
- نرسل إليك بالبريد الإلكتروني رابطًا ورمزًا مكوّنًا من 6 أرقام.
- افتح الرابط واضغط على Start my day pass (بدء تصريحي ليوم واحد)، أو أدخل الرمز في صفحة التسجيل. تُفتح لوحة التحكم ويظهر فيها مفتاح API الخاص بك.
دع وكيل الذكاء الاصطناعي يبدأ التصريح نيابةً عنك
الصق هذه التعليمة للوكيل في Claude أو ChatGPT أو Cursor أو أي وكيل يمكنه إرسال طلبات HTTP:
Read https://listingsapi.com/docs/day-pass.md and start a listingsAPI sandbox day pass for me. Ask me for my first name, last name, email and company, and confirm that I accept the Terms of Service and Privacy Policy before you sign up. Then ask me for the 6-digit code from the email, or wait while I press Start my day pass in it. With the API key, create one sample location, show me which demo directories it synced to with their links, change its opening hours, and read the listings back. Use only the day pass sandbox, and show me the integration code you used.
ينفّذ الوكيل الاستدعاءات الواردة في القسم التالي. لا يحتاج إلى لوحة التحكم مطلقًا، ولا يُرسَل المفتاح إلا إلى الوكيل الذي طلب التصريح.
ابدأ التصريح برمجيًا
تعمل API التصريح ليوم واحد على الأصل (origin) نفسه الذي تعمل عليه REST API، ولا يحتاج أي من استدعاءاتها إلى مفتاح. تحقّق مما إذا كان التصريح ليوم واحد متاحًا، واطّلع على حدوده:
curl https://listingsapi.com/api/day-pass1. اطلب التصريح ليوم واحد
curl -X POST https://listingsapi.com/api/day-pass/signup \ -H "Content-Type: application/json" \ -d '{ "first_name": "Ada", "last_name": "Lovelace", "email": "ada@example.com", "company": "Analytical Engines", "accept_terms": true }'لا تضبط accept_terms إلا بعد موافقة الشخص على شروط الخدمة وسياسة الخصوصية. تكون الاستجابة 202، ونرسل إلى الشخص بالبريد الإلكتروني رابطًا ورمزًا مكوّنًا من 6 أرقام. لحماية خصوصية الأشخاص، يتلقى كل طلب مسموح به الاستجابة نفسها: إذا كان البريد الإلكتروني مرتبطًا بالفعل بحساب لدى listingsAPI أو سبق استخدام التصريح ليوم واحد المرتبط به، فإننا نُبلغ صاحبه بذلك في تلك الرسالة بدلًا من الرابط والرمز، ولا يبدأ الطلب أبدًا.
{ "status": "verification_sent", "email": "ada@example.com", "expires_in": 86400, "poll_token": "9f2c…64 hexadecimal characters…", "poll_interval_seconds": 5, "next": { "tell_the_user": "We emailed ada@example.com a link and a 6-digit code. …", "with_code": { "method": "POST", "url": "https://listingsapi.com/api/day-pass/start" }, "or_poll": { "method": "POST", "url": "https://listingsapi.com/api/day-pass/status" } }, "docs": "https://listingsapi.com/docs/day-pass"}احتفظ بـpoll_token سرًا. فهو يربط الرمز والمفتاح بطلبك، لذا يمكن لأي شخص يحوزه الحصول على مفتاح API بمجرد بدء التصريح.
2. ابدأه باستخدام الرمز المرسل عبر البريد الإلكتروني
اطلب من الشخص الرمز المكوّن من 6 أرقام الوارد في رسالة البريد الإلكتروني، ثم أرسله مع poll_token:
curl -X POST https://listingsapi.com/api/day-pass/start \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>", "code": "482913" }'لا يعمل الرمز إلا مع poll_token الخاص بالطلب الذي أُرسل الرمز من أجله، لذا لا يمكن إدخاله في الموقع الإلكتروني بدلًا من ذلك.
أو انتظر حتى يضغط المالك على بدء
إذا كان الشخص يفضّل الضغط على Start my day pass (بدء تصريحي ليوم واحد) في رسالة البريد الإلكتروني، فتحقّق دوريًا باستخدام poll_token كل 5 ثوانٍ:
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'إلى أن يضغط عليه، تكون الاستجابة {"status": "pending"} مع ترويسة Retry-After. وبعد ذلك، تكون الاستجابة هي بيانات الاعتماد نفسها التي يُرجعها استدعاء البدء.
بيانات الاعتماد
{ "status": "active", "api_key": "dp.…", "authorization_header": "API dp.…", "api_base_url": "https://listingsapi.com", "mcp_url": "https://listingsapi.com/mcp", "expires_at": "2026-09-26T10:04:11Z", "limits": { "locations": 2, "requests_per_minute": 30, "requests_per_day": 1500 }, "includes": ["locations", "listings"], "demo_directories": [ { "name": "MapQuest", "sync": "instant" }, { "name": "N49", "sync": "delayed" } ], "dashboard_url": "https://listingsapi.com/dashboard", "docs": "https://listingsapi.com/docs/day-pass", "next_steps": ["Create a location: POST https://listingsapi.com/api/v4/locations …"]}تبدأ مفاتيح تصريح ليوم واحد بـ dp.، ولا تقبلها واجهة API وخادم MCP إلا لنقاط نهاية المواقع وإدراجات الأنشطة التجارية. يتضمن limits القيم الحالية للتصريح، ويسرد demo_directories الأدلة العشرة كلها. إذا فُقدت استجابة، فإن إعادة محاولة استدعاء البدء أو التحقّق الدوري مرة أخرى تُرجع المفتاح نفسه لمدة 10 دقائق؛ وبعد ذلك يُغلق الطلب. لا تُحتسب ضمن المحاولات الخمس التي يسمح بها الرمز إلا الرموز الخاطئة. يمكن للمالك تسجيل الدخول إلى لوحة التحكم في أي وقت باستخدام Email me a sign-in link (أرسل إليّ رابط تسجيل الدخول عبر البريد الإلكتروني).
الأخطاء
ربط MCP
يستقبل خادم MCP المستضاف مفتاح تصريح ليوم واحد في الترويسة نفسها التي تستخدمها واجهة REST API. بالنسبة إلى Claude Code:
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"تتوفر إعدادات Cursor وWindsurf وCodex وغيرها من العملاء في صفحة MCP. أما العملاء الذين يسجّلون الدخول باستخدام OAuth، مثل موصّل listingsAPI في دليل Claude أو موصّل مخصّص في Claude، فيفتحون صفحة تسجيل الدخول إلى listingsAPI بدلًا من ذلك: اختر Email me a sign-in link (أرسل إليّ رابط تسجيل الدخول عبر البريد الإلكتروني) باستخدام البريد الإلكتروني الخاص بالتصريح ليوم واحد. عند استخدام تصريح ليوم واحد، يوفّر الخادم أدوات المواقع وإدراجات الأنشطة التجارية والتوثيق والحساب، بما فيها locations_create وlocations_update وlistings_premium.
اعثر على listingsAPI في أدلة أدوات الذكاء الاصطناعي
خادم MCP ومهارة الوكيل listingsAPI مُدرجان في هذه الأدلة، بحيث يمكنك أنت أو وكيلك تثبيتهما من الدليل الذي يستخدمه عميلك بالفعل:
إضافة مهارات الوكيل
نُشرت خمس مهارات لوكيل listingsAPI على skills.sh. عند استخدام تصريح ليوم واحد، تكون listingsapi-integration وlistingsapi-listing-audit مناسبتين: فهما تستخدمان المواقع وإدراجات الأنشطة التجارية التي يشملها التصريح. تحتاج مهارات التقييمات والنشر وإعداد التقارير إلى ميزات لا يشملها تصريح ليوم واحد. ثبّت المهارتين باستخدام Skills CLI:
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-auditإنشاء موقع
يجب أن يكون العنوان حقيقيًا وقابلًا للترميز الجغرافي، وأن يتكوّن رقم الهاتف من 10 أرقام، وألا يقل الوصف عن 200 حرف. لا بأس باستخدام موقع تجريبي، لأنه لا يصل إلا إلى الأدلة التجريبية.
curl -X POST https://listingsapi.com/api/v4/locations \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": { "name": "Acme Kitchen", "description": "Acme Kitchen is a family-owned neighborhood restaurant in downtown New York serving wood-fired pizza, hand-rolled pasta, and a short seasonal menu built around produce from nearby growers. Our dining room seats forty, takeout and delivery run until close.", "street": "350 5th Ave", "city": "New York", "stateIso": "NY", "postalCode": "10118", "countryIso": "US", "phone": "6443859313", "bizUrl": "https://acmekitchen.example.com", "subCategoryId": 1432 } }'تتضمن الاستجابة الموقع الجديد ضمن data.createLocation.location. احتفظ بقيمة id الخاصة به والمرمّزة بصيغة base64 لاستخدامها في الاستدعاءات أدناه.
راقب المزامنة
curl "https://listingsapi.com/api/v4/locations/<location-id>/listings/premium" \ -H "Authorization: API $LISTINGSAPI_KEY"يتضمن كل سجل ضمن data.listingsForLocation اسم دليل تجريبي وقيمة syncStatus الخاصة به. تعرض 7 أدلة الحالة SYNCED في غضون ثوانٍ، مع listingUrl يفتح الصفحة التجريبية. تعرض أدلة N49 وChamber of Commerce وHotfrog الحالة IN_PROGRESS أولًا لمدة تتراوح بين 30 و90 ثانية، لتتمكن من مراقبة تغيّر الحالة. تحمل الصفحات التجريبية علامات توضح أنها بيئات اختبار، وهي مخفية عن محركات البحث وبرامج زحف الذكاء الاصطناعي.
غيّر حقلًا وتحقق مرة أخرى
أرسل الحقول التي تغيّرها فقط. بالنسبة إلى ساعات العمل، أرسل الأسبوع كاملًا:
curl -X POST https://listingsapi.com/api/v4/locations/update \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": { "id": "<location-id>", "businessHours": [ { "day": "MONDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "TUESDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "WEDNESDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "THURSDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "FRIDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "SATURDAY", "type": "CLOSED", "slots": [] }, { "day": "SUNDAY", "type": "CLOSED", "slots": [] } ] } }'تُرجع عملية التحديث رمز حالة HTTP 200 حتى عند فشل التحقق من صحة البيانات، لذا تحقق من success في جسم الاستجابة، ثم اقرأ إدراجات الأنشطة التجارية المميزة مرة أخرى.
تعليمات للوكيل يمكنك تجربتها
بعد توصيل خادم MCP، الصق إحدى التعليمات التالية في وكيلك:
Use the listingsAPI tools to create a sample location for a coffee shop at a real street address in Austin, TX, with a 10-digit phone number, a website and a description of at least 200 characters. Then show its premium listings as a table of directory, syncStatus and listingUrl.
Show the premium listings for my listingsAPI location again. Tell me which demo directories are synced and which are still in progress, and give me the link to each demo listing page.
Update my listingsAPI location's opening hours to 8am to 6pm on weekdays and closed on weekends, sending the full seven-day week. Then check its premium listings again and tell me what changed.
بعد 24 ساعة
يتوقف مفتاح API عن العمل وتطلب منك لوحة التحكم الترقية. تتاح لك بعد ذلك 48 ساعة للتسجيل في Launch أو Growth باستخدام عنوان البريد الإلكتروني نفسه؛ نرسل إليك عبر البريد الإلكتروني رابطًا لتعيين كلمة مرور، ويُحذف حساب بيئة الاختبار فور إنشاء الحساب الجديد. إذا لم تُرقِّ خلال تلك الساعات الـ48، يُحذف حساب بيئة الاختبار وبياناته. لا تُنقل مواقع بيئة الاختبار أبدًا إلى خطة مدفوعة.
الأسئلة الشائعة
هل مفتاح API لبيئة الاختبار مجاني، وهل أحتاج إلى بطاقة ائتمان؟
التصريح ليوم واحد لبيئة الاختبار مجاني. لا يلزم تقديم بطاقة ائتمان أو كلمة مرور. يُتاح التصريح لفترات محدودة؛ تحقق من التوفر الحالي قبل التسجيل.
ما مدة صلاحية تصريح ليوم واحد؟
يسري التصريح لمدة 24 ساعة من وقت تفعيله، عند الضغط على Start my day pass (بدء تصريحي ليوم واحد) عبر الرابط المُرسل بالبريد الإلكتروني أو استخدام الرمز المكوّن من 6 أرقام والمُرسل بالبريد الإلكتروني.
ما الذي يمكنني اختباره باستخدام مفتاح API لبيئة الاختبار؟
يمكنك إنشاء ما يصل إلى موقعين وتحديثهما وقراءة إدراجات أنشطتهما التجارية باستخدام REST أو MCP. لا تُزامَن إدراجات الأنشطة التجارية إلا مع 10 أدلة تجريبية من listingsAPI، ولا تُزامَن أبدًا مع منصات نشر حقيقية. لا يشمل ذلك التقييمات أو المنشورات أو ميزات التواصل الاجتماعي أو التحليلات أو الحسابات المتصلة أو webhooks أو المواقع الإضافية.
هل يمكن لوكيل ذكاء اصطناعي الحصول على مفتاح لبيئة الاختبار نيابةً عني؟
نعم. يمكن لوكيل طلب تصريح ليوم واحد باستخدام اسمك وبريدك الإلكتروني وشركتك بعد موافقتك على شروط الخدمة وسياسة الخصوصية. تتحقق من بريدك الإلكتروني باستخدام الرابط أو الرمز المكوّن من 6 أرقام المُرسل بالبريد الإلكتروني، ويتلقى الوكيل الذي قدّم الطلب مفتاح API. لا تتطلب استدعاءات التسجيل والبدء والحالة مفتاح API.
هل هذا مماثل للفترة التجريبية المجانية لمدة 14 يومًا؟
لا. تعمل الفترة التجريبية لمدة 14 يومًا ضمن خطة مدفوعة مع وجود بطاقة مسجلة، وتتيح النشر في أدلة حقيقية. لا يتطلب تصريح ليوم واحد بطاقة، ويسري ليوم واحد، ويتيح النشر في الأدلة التجريبية فقط. يمكن لكل عنوان بريد إلكتروني استخدام تصريح ليوم واحد مرة واحدة، وعملاء listingsAPI الحاليون غير مؤهلين للحصول عليه.