استخدام GraphQL API

​

العثور على عملية

​

الاستعلامات للقراءة، والطفرات للكتابة

• يتحقق validatePost من منشور دون نشره.
• يتحقق validateMedia من إمكانية الوصول إلى عنوان URL للوسائط.
• generatePost هو استعلام لأنه لا يتغير شيء لدينا. لكنه لا يزال يُحتسب كاستدعاء API ويُرجع نصًا مختلفًا في كل مرة، لذا تأكد من أن ذاكرة التخزين المؤقت لدى العميل أو إعادة الجلب التلقائية لا تكرره دون أن تلاحظ.
• mediaUploadUrl هو طفرة لأنه يُنشئ عنوان URL للرفع خاصًا بحسابك.
• linkAnalytics هو طفرة لأنه قد يطلب تقريرًا يُرسَل عبر البريد الإلكتروني.
• userBatch هو طفرة لأنه يبدأ مهمة تصدير.

​

إنشاء منشور

mutation {
  createPost(input: {
    post: "Hello from GraphQL"
    platforms: [LINKEDIN]
    idempotencyKey: "post-2026-09-01-001"
  }) {
    status
    id
  }
}

mutation {
  createPost(input: {
    post: "New video"
    platforms: [YOUTUBE]
    mediaUrls: ["https://example.com/video.mp4"]
    idempotencyKey: "youtube-video-001"
    youTubeOptions: {
      title: "My video"
      visibility: PUBLIC
    }
  }) {
    status
    id
    postIds { platform postUrl }
  }
}

​

أنواع الوسائط

​

التعدادات

{ socialAnalytics(platforms: [INSTAGRAM, TIKTOK]) }

​

النوع القياسي (scalar) JSON

• يقبل explainError(code:) القيمة 215 أو “215”، لأن العملاء يحتفظون برموز الأخطاء بالصيغتين.
• يستخدم createPost(input:) صيغة JSON لحقول مثل post وmediaUrls، والتي يمكن أن تكون قيمًا مشتركة أو كائنات خاصة بكل منصة.
• يأخذ createAutomation(triggers:, actions:) مصفوفات تعتمد حقولها على type الخاص بكل عنصر.
• يقبل boostFacebookPost(interests:) معرّفات اهتمامات Meta كسلاسل نصية أو أرقام.

​

الوسائط الاختيارية والقيم الفارغة

​

قراءة الاستجابات

mutation {
  createPost(input: {
    post: "Hi"
    platforms: [LINKEDIN]
    idempotencyKey: "linkedin-hi-001"
  }) {
    status
    id
    postIds { platform postUrl }
    errors { platform message code }
  }
}

mutation {
  createPost(input: {
    post: "Hi"
    platforms: [LINKEDIN]
    idempotencyKey: "linkedin-hi-001"
  }) {
    status
    raw
  }
}

​

رفع الوسائط

1. اطلب عنوان URL للرفع:
   mutation { mediaUploadUrl(contentType: "image/jpeg") }
   
2. اقرأ data.mediaUploadUrl.uploadUrl وaccessUrl وcontentType من JSON المُرجَع.
3. نفّذ PUT لملفك مباشرة إلى uploadUrl، وليس إلى Ayrshare API، مع تعيين ترويسة Content-Type للطلب إلى قيمة contentType المُرجَعة.
4. بعد نجاح الرفع، مرّر accessUrl في createPost.input.mediaUrls:
   mutation {
     createPost(input: {
       post: "With a photo"
       platforms: [INSTAGRAM]
       mediaUrls: ["https://the-returned-access-url"]
       idempotencyKey: "instagram-photo-001"
     }) {
       status
       postIds { platform postUrl }
     }
   }
   

​

اقرأ التالي

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