Sử dụng GraphQL API

​

Tìm một thao tác

​

Query để đọc, mutation để ghi

• validatePost kiểm tra một bài đăng mà không xuất bản nó.
• validateMedia kiểm tra xem một URL media có truy cập được không.
• generatePost là một query vì không có gì thay đổi ở phía chúng tôi. Nó vẫn được tính là một lệnh gọi API và trả về văn bản khác nhau mỗi lần, vì vậy hãy đảm bảo bộ nhớ đệm phía client hoặc cơ chế tự động refetch không lặp lại nó mà bạn không hay biết.
• mediaUploadUrl là một mutation vì nó tạo một URL tải lên cho tài khoản của bạn.
• linkAnalytics là một mutation vì nó có thể yêu cầu một báo cáo gửi qua email.
• userBatch là một mutation vì nó khởi chạy một tác vụ xuất dữ liệu.

​

Tạo bài đăng

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 }
  }
}

​

Kiểu đối số

​

Enum

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

​

Scalar JSON

• explainError(code:) chấp nhận 215 hoặc “215”, vì khách hàng lưu mã lỗi ở cả hai dạng.
• createPost(input:) dùng JSON cho các trường như post và mediaUrls, vốn có thể là giá trị dùng chung hoặc object theo từng nền tảng.
• createAutomation(triggers:, actions:) nhận các mảng mà trường của chúng phụ thuộc vào type của từng phần tử.
• boostFacebookPost(interests:) chấp nhận id sở thích của Meta dưới dạng chuỗi hoặc số.

​

Đối số tùy chọn và null

​

Đọc phản hồi

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
  }
}

​

Tải media lên

1. Yêu cầu một URL tải lên:
   mutation { mediaUploadUrl(contentType: "image/jpeg") }
   
2. Đọc data.mediaUploadUrl.uploadUrl, accessUrl và contentType từ JSON được trả về.
3. PUT tệp của bạn trực tiếp đến uploadUrl, không phải đến Ayrshare API, đặt header Content-Type của request thành contentType được trả về.
4. Sau khi tải lên thành công, truyền accessUrl vào 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 }
     }
   }
   

​

Đọc tiếp

• Lỗi — mã trạng thái HTTP, cấu trúc lỗi và thành công một phần.
• Giới hạn và Tính phí — giới hạn kích thước truy vấn và cách tính số request.