AT AppointmentTrader
تسجيل الدخول
متصلون الآن  
Partner Programs تكامل API · REST عامة

اتصل بـ AT
من أي مكان.

واجهة REST موثقة لكل حجز، عرض، معاملة، ومكان على AppointmentTrader. HTTPS عادي، JSON مدخل ومخرج، أشكال أخطاء متوقعة — نفس النقاط النهائية التي تشغل تطبيق الويب AT، متاحة لخوادمك.

اقرأ الوثائق احصل على مفتاح API
  • 120+نقاط نهاية عامة
  • 99.9%التوافر، آخر 12 شهرًا
  • <120msزمن استجابة p95، الحافة
curl · أي لغة JavaScript SDK Python SDK PHP SDK REST · JSON API key · HMAC خطافات الويب · signed
كيف يعمل

ثلاث خطوات. مفتاح واحد. خمس دقائق للمكالمة الأولى.

  1. 01

    احصل على مفتاح API

    مجاني، فوري، محدد النطاق. تعمل النقاط العامة بدون مفتاح؛ تحتاج النقاط المخصصة للمستخدم إلى مفتاح API ومنح لكل مستخدم. لا مندوب مبيعات، لا قائمة انتظار — النموذج موجود على /api-documentation.

  2. 02

    اضغط /v1/...

    HTTPS عادي، JSON مدخل ومخرج، أشكال أخطاء متوقعة. كل ما يستخدمه تطبيق AppointmentTrader موجود هنا، موثق، مع طلبات وأشكال استجابة نموذجية. لا بوابة GraphQL، لا مفاجآت بروتوكول.

  3. 03

    هل تحتاج واجهة داخل AT؟

    غيّر المسار. مسار تطوير التطبيقات يغلف تطبيقك في غلاف AT — نفس النقاط، بالإضافة إلى SDK، إدخال الشريط الجانبي، وتثبيت البوابة.

عائلات النقاط النهائية

ستة أسطح. عقد واحد.

مرجع كامل

بيانات السوق

عامة
/v1/marketdata/get_world_top

المدن الرائجة، أسعار التغطية، معدلات التنفيذ، المعاملات الأخيرة. نفس الواجهة التي تشغل لافتة AT العامة — صديقة SSR، نوع JSON، مع ترقيم صفحات.

العروض والطلبات

مفتاح API
/v1/concierge/categorize_request

قدم نية شراء، احصل على تطابق مكان محلل. جلب العروض المفتوحة، قدم عرضًا مضادًا، اسقط عرضًا. نفس الشكل المستخدم في مؤلف النية داخل التطبيق.

المعاملات

مفتاح API
/v1/transaction/list

تاريخ المعاملات المصادق عليه لكل مستخدم، مصفى حسب الحالة، النطاق الزمني، الموقع. اشتراكات webhook لتغييرات الحالة (مدفوع، منقول، مسترد).

المواقع

عامة
/v1/location/search

بحث عن أماكن، إكمال تلقائي، ساعات العمل، السعة، الصور. نفس قاعدة البيانات التي تشغل شريط بحث AT — مفهرسة عبر 12 فئة من المطاعم إلى مواعيد DMV.

الإشعارات

مفتاح API
/v1/notification/subscribe

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

المستخدم والاجتماعي

مفتاح API
/v1/user/get_profile

الملفات الشخصية، التقييمات، رسم المتابعة، خلاصات النشاط. للقراءة فقط على السطح العام؛ CRUD كامل عند الاستدعاء من داخل إطار مضيف للتطبيق مع رمز SDK صالح.

120+
نقاط نهاية عامة عبر ستة أسطح
99.9%
مدة تشغيل 12 شهرًا، السطح العام والمصادق عليه
<120ms
زمن استجابة p95 من الحافة، كل منطقة
$0
طبقة مجانية، لا حاجة لبطاقة ائتمان للبدء
الأسئلة الشائعة

الإجابات الصادقة.

ما التكلفة؟

مجاني للسطح العام (بيانات السوق، بحث الموقع) بمعدلات الاستخدام العادل. نقاط النهاية المخصصة للمستخدم — تلك التي تتعامل مع حجوزات المستخدم الحقيقية — مجانية لأول 10,000 مكالمة شهريًا، ثم تُحسب. توزيع مضيف التطبيق (تطبيقك داخل /apps/{id}/) is free; we revenue-share only on transactions you originate.

ما هي حدود المعدل؟

60 طلب/دقيقة على السطح العام، بدون مصادقة. 600 طلب/دقيقة مع مفتاح API. نقاط النهاية المخصصة للمستخدم تحصل على نافذة انزلاقية لكل مستخدم؛ فشل ناعم عند الحد، وفشل صلب بعد سوء استخدام مستمر. كل استجابة تحمل X-RateLimit-Remaining و X-RateLimit-Reset — no surprises.

هل هناك بيئة اختبار؟

نعم. أضف ?sandbox=1 إلى أي نقطة نهاية، أو استخدم نفس المسار على sandbox.appointmenttrader.com. Same shapes, same auth, fixture data — transactions don't move real money, notifications don't ship to real users, and you can reset the world from the partner dashboard.

هل تدعم الويب هوكس؟

نعم — موقعة بـ HMAC، تُعاد المحاولة مع تراجع، قابلة لإعادة التشغيل من لوحة التحكم. الاشتراك حسب الموضوع (bid.filled, transaction.confirmed, message.received, etc.) with an API key plus a per-user grant. We deliver from a stable IP range you can allowlist; logs and replays live in the partner dashboard for 30 days.

متى يجب أن أنتقل إلى تطوير التطبيقات بدلاً من ذلك؟

عندما يعيش مستخدموك داخل AppointmentTrader. API مباشر: تطبيقك، خوادمك، توزيعك — يمنح المستخدمون مفتاح API الخاص بك من إعداداتهم، وأنت تستدعي /v1/ من خلفية تملكها. تطوير التطبيقات: your app loads inside an iframe on AT, gets a sidebar entry, an SDK token auto-issued for the active user, and ships into the user's portal beside our own surfaces. Same endpoints, same data, different reach — pick by where your users already are.

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

/api-documentation#auth. Sign in to AT, click Generate, copy the key. The first request can land 30 seconds later. There's no review queue for the public tier; user-scoped grants flip on per-app review (typically same-day).

رمزك، سوقنا. ابدأ خلال خمس دقائق.

طبقة مجانية. لا بطاقة ائتمان. لا مكالمة مبيعات. نفس السطح الذي يشغل كل ما تراه على AppointmentTrader.

اقرأ الوثائق Back to Partner Programs

أكثر من 120 نقطة نهاية عامة. 99.9% مدة تشغيل. p95 أقل من 120 مللي ثانية.