ข้ามไปยังเนื้อหา
MarcommAI

เชื่อมต่อ Make ด้วยโมดูล HTTP

แอป Marcomm AI สำหรับ Make อยู่ระหว่างตรวจสอบ ระหว่างนี้ให้เรียก API ของ Marcomm AI จากสถานการณ์ใน Make ด้วยโมดูล HTTP และคีย์ API ส่วนบุคคล

  1. 1
    ใน Marcomm ไปที่ ตั้งค่า → การเชื่อมต่อ → Make เพื่อดูสถานะและค่าที่ต้องใช้
    หน้าตั้งค่า การเชื่อมต่อ Make ที่แสดงสถานะ ขั้นตอนการเชื่อมต่อ สโคปที่ต้องเลือก และสถานะการเข้าถึง API
    หน้า Make แสดงสถานะปัจจุบัน ขั้นตอน ค่าที่ต้องคัดลอก และบอกว่าเวิร์กสเปซนี้ได้รับอนุมัติการเข้าถึง API แล้วหรือยัง
  2. 2
    เปิด ตั้งค่า → API หากเวิร์กสเปซยังไม่มีสิทธิ์ใช้งาน API เจ้าของหรือผู้ดูแลจะกรอก ขอสิทธิ์ใช้งาน API แล้วเลือก ส่งคำขอ
  3. 3
    เมื่อได้รับอนุมัติ เปิด สร้างคีย์ เลือก คีย์ส่วนบุคคล ติ๊ก ขอบเขตสิทธิ์ ที่ต้องการ แล้วเลือก สร้างคีย์ คัดลอกคีย์ทันทีเพราะจะแสดงเพียงครั้งเดียว
  4. 4
    ในสถานการณ์ของ Make เพิ่มโมดูล HTTP แล้วเลือก Make a request
  5. 5
    ใส่ endpoint จากเอกสารสำหรับนักพัฒนาต่อท้าย https://marcomm.works/api/v1 แล้วเพิ่มเฮดเดอร์ Authorization เป็น Bearer ตามด้วยคีย์ของคุณ

เริ่มด้วย GET /me เพื่อตรวจคีย์ก่อนสร้างส่วนที่เหลือของสถานการณ์

แอป Marcomm AI สำหรับ Make อยู่ระหว่างตรวจสอบและยังเพิ่มไม่ได้ เมื่อได้รับอนุมัติ โมดูล Make an API call จะเรียก endpoint ใดก็ได้ในเอกสารอ้างอิง API ด้วยคีย์ส่วนบุคคลเดียวกัน ระหว่างนี้โมดูล HTTP ทำงานเดียวกันได้ อีเวนต์ของ Marcomm AI ยังส่งไปยังที่อยู่ webhook ของ Make ที่คุณเพิ่มในแท็บ Webhook ของ ตั้งค่า → API ได้ด้วย

ขอบเขตสิทธิ์กำหนดว่าคีย์ทำอะไรได้ เนื้อหา (content) อ่านข่าวประชาสัมพันธ์ บทความบล็อก และกิจกรรมสื่อ เขียนเนื้อหา (content:write) สร้างและแก้ไขฉบับร่าง เผยแพร่และส่ง (distribution) เผยแพร่และส่งทางอีเมล และ การอนุมัติ (approvals) ครอบคลุมขั้นตอนการอนุมัติ สามอย่างหลังใช้ได้กับ คีย์ส่วนบุคคล เท่านั้น เพราะการกระทำจะถูกบันทึกในชื่อของผู้สร้างคีย์ คีย์เวิร์กสเปซ อ่านได้อย่างเดียว และทุกคีย์ทำงานตามบทบาทและสิทธิ์ของผู้สร้าง

การเผยแพร่และการส่งยกเลิกไม่ได้ API จะทำก็ต่อเมื่อคำขอมี confirm: true หรือเฮดเดอร์ Idempotency-Key และจะไม่เผยแพร่อะไรแต่ตอบ 409 หากยังต้องอนุมัติ หรือเนื้อหาตั้งเวลาไว้หรืออยู่ระหว่างช่วงห้ามเผยแพร่ การลองใหม่ด้วย Idempotency-Key และคำขอเดิมจะได้ผลลัพธ์แรกกลับมาภายใน 24 ชั่วโมงแทนการทำซ้ำ ในโมดูล HTTP ให้เพิ่มเฮดเดอร์ Idempotency-Key เองในทุกคำขอที่เขียนข้อมูล

API ใช้ได้ในแพ็กเกจ Team ขึ้นไป ทีม Marcomm AI ตรวจสอบคำขอทีละรายการ และคีย์จะใช้ได้หลังได้รับอนุมัติเท่านั้น คีย์ใช้ได้เฉพาะขอบเขตสิทธิ์ที่อนุมัติให้เวิร์กสเปซ และแต่ละคนมีคีย์ได้สูงสุด 10 รายการ ค่าเริ่มต้นคือเวิร์กสเปซละ 60 คำขอต่อนาทีและ 10,000 คำขอต่อวัน หากเกิน API จะตอบ 429 พร้อมเฮดเดอร์ Retry-After หากต้องการเพิ่มขีดจำกัด ให้ใช้ ต้องการขีดจำกัดที่สูงขึ้นไหม ใน ตั้งค่า → API หากต้องการเลิกเชื่อมต่อ Make ให้เลือก เพิกถอน ข้างคีย์ ระบบที่ใช้คีย์นั้นจะเข้าถึงไม่ได้ทันที

คำถามที่พบบ่อย

เรียก GET https://marcomm.works/api/v1/me พร้อมเฮดเดอร์ Authorization: Bearer ตามด้วยคีย์ของคุณ ใช้ได้กับคีย์ที่อนุมัติแล้วทุกคีย์ไม่ว่าจะมีขอบเขตสิทธิ์ใด และจะส่งเวิร์กสเปซ ชื่อคีย์ และขอบเขตสิทธิ์ของคีย์กลับมา

คีย์ไม่ได้บันทึกว่าบริการใดใช้งาน Marcomm จึงไม่ทำเครื่องหมายการ์ด Make ว่าเชื่อมต่อแล้ว ดูได้ว่าแต่ละคีย์ถูกใช้ล่าสุดเมื่อใดใน ตั้งค่า → API

ใส่ https://marcomm.works/api/v1 ตามด้วยพาธจากเอกสารสำหรับนักพัฒนา เช่น /press-releases เพื่อดูรายการข่าวประชาสัมพันธ์

การเชื่อมต่อ