نظرة عامة على GraphQL API

https://api.ayrshare.com/graphql

​

استعلامك الأول

curl -X POST https://api.ayrshare.com/graphql \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ postHistory(lastDays: 7) }"}'

{
  "data": {
    "postHistory": {
      "history": [
        { "id": "RkQ8uXg2jT7bNd1Wq0Ya", "status": "success", "post": "Hello world" }
      ],
      "refId": "9d2a7c41f0b8e6d35a1c",
      "count": 1,
      "lastUpdated": "2026-09-24T12:00:00.000Z",
      "nextUpdate": "2026-09-24T12:00:00.000Z"
    }
  }
}

​

طلب عدة أشياء في آن واحد

{
  history: postHistory(lastDays: 7)
  accounts: user
  comments: comments(id: "abc123")
  analytics: socialAnalytics(platforms: [INSTAGRAM])
}

​

المصادقة

Authorization: Bearer YOUR_API_KEY

• أرسل Profile-Key كقيمة افتراضية على مستوى الطلب بأكمله.
• مرّر profileKey في حقل منفرد لتجاوز تلك القيمة الافتراضية، مما يسمح لطلب واحد بالعمل على أكثر من ملف شخصي.

​

جرّبها دون كتابة أي شيفرة

​

هل تستخدم GraphQL أم REST؟

• تحتاج إلى عدة أجزاء غير مترابطة من البيانات وتريدها في رحلة ذهاب وإياب واحدة.
• تريد أسماء عمليات ووسائط وكائنات إدخال وتعدادات وتحديدات استجابة ذات أنواع قابلة للقراءة آليًا. تظل معظم الاستجابات بصيغة JSON حتى تحتفظ بغلاف REST الكامل؛ ويُرجع createPost حاليًا PostResult ذا نوع محدد.
• تستكشف واجهة API وتريد رؤية ما هو موجود دون التنقل بين صفحات التوثيق.

• ترفع ملفات. لا يمكن لبايتات الوسائط أن تنتقل عبر طلب GraphQL؛ راجع رفع الوسائط لمعرفة المسار المدعوم.
• تستخدم إحدى حزم SDK أو تكاملات بدون شيفرة الخاصة بنا، والتي تتعامل عبر REST.
• تريد أصغر قدر ممكن من التبعيات. لا يحتاج استدعاء REST إلى شيء سوى عميل HTTP.

​

اقرأ التالي

• استخدام واجهة API: العثور على العمليات، وأنواع الوسائط، ورفع الوسائط.
• الأخطاء: حالات الفشل التي تُغيّر حالة HTTP، ولماذا تُرجع العمليات الفاشلة HTTP 200 مع ذلك، وكيفية التعامل مع النجاح الجزئي.
• الحدود والفوترة: الحدود القصوى لحجم الاستعلام وكيفية احتساب الطلبات.