AR
للمنظمين

واجهة الكتالوج البرمجية

واجهة برمجية عامة ومجانية للقراءة فقط للفعاليات القادمة والأماكن والفنانين على Tixvio.

العنوان الأساسي

القواعد

  • لا حاجة إلى مفتاح أو تسجيل؛ الواجهة للقراءة فقط (GET).
  • حتى 120 طلباً في الدقيقة لكل عنوان IP؛ بعد ذلك تُعاد استجابة 429 مع ترويسة Retry-After.
  • الفعاليات الحقيقية المنشورة والمدرجة علناً فقط: لا يشمل ذلك المحتوى التجريبي، ولا الفعاليات المتاحة بالرابط فقط، ولا فعاليات «قريباً» التي لم يبدأ بيعها.
  • الأسعار أعداد صحيحة بأصغر وحدة للعملة (قروش / سنتات)؛ والأوقات بصيغة ISO 8601 (UTC)، وتُقام الفعاليات بتوقيت Europe/Istanbul.
  • قد تبقى الاستجابات في الذاكرة المؤقتة حتى 5 دقائق؛ وجّه المستخدمين دائماً إلى رابط الفعالية url لشراء التذاكر.
  • لا إعلانات ولا بيانات شخصية. اذكر Tixvio مصدراً وضع رابطاً لصفحة الفعالية عند عرض البيانات.

نقاط النهاية

الطريقةالمسارالوصف
GET/api/public/v1/eventsالفعاليات القادمة: q (بحث)، city، genre، from / to (YYYY-MM-DD)، free=1، page، limit (50 كحد أقصى).
GET/api/public/v1/events/{slug}تفاصيل الفعالية: الوصف وعنوان المكان وموقعه والمنظِّم وأنواع التذاكر (العروض).
GET/api/public/v1/venuesأماكن لديها فعاليات قادمة: q، city، page، limit.
GET/api/public/v1/venues/{slug}تفاصيل المكان وفعالياته القادمة.
GET/api/public/v1/artistsفنانون لديهم فعاليات قادمة: q، genre، page، limit.
GET/api/public/v1/artists/{slug}تفاصيل الفنان وروابطه الرسمية وفعالياته القادمة.
GET/api/public/v1/feed.jsonجميع الفعاليات القادمة مع أنواع التذاكر في ملف واحد (1000 كحد أقصى، يُحدَّث كل 10 دقائق).
GET/api/public/v1/openapi.jsonمستند OpenAPI 3.1: جميع الحقول والمعاملات.

مثال على طلب

أقرب خمس فعاليات تكنو في إسطنبول (الاستجابة مختصرة):

curl "https://tixvio.com/api/public/v1/events?city=%C4%B0stanbul&genre=Techno&limit=5"
{
  "page": 1,
  "hasMore": true,
  "events": [
    {
      "slug": "example-night",
      "url": "https://tixvio.com/e/example-night",
      "title": "Example Night",
      "startsAt": "2026-11-21T19:00:00.000Z",
      "timezone": "Europe/Istanbul",
      "city": "İstanbul",
      "genres": [
        "Techno"
      ],
      "status": "PUBLISHED",
      "saleMode": "ON_SALE",
      "currency": "TRY",
      "priceFrom": 45000,
      "soldOut": false,
      "venue": {
        "slug": "example-venue",
        "name": "Example Venue",
        "city": "İstanbul"
      }
    }
  ]
}

مساعدو الذكاء الاصطناعي ومحركات البحث

يلخّص ملف llms.txt الموقع وروابط واجهة الكتالوج والفعاليات القادمة لمساعدي الذكاء الاصطناعي. موجز الفعاليات ومستند OpenAPI عامّان أيضاً، ويسمح ملف robots.txt بفهرستهما.

لديك سؤال أو فكرة شراكة؟راسلنا للحصول على حد طلبات أعلى أو موجز للشركاء أو تكامل.اتصل بنا