คู่มือเวิร์กโฟลว์ API

คุณต้องการสร้างอะไร?

เลือกผลลัพธ์ที่ใกล้เคียงกับงานของคุณที่สุด แต่ละเส้นทางจะให้คำขอที่ใช้งานได้หนึ่งรายการ, สิ่งที่การตอบสนองควรมี, วิธีตรวจสอบว่าทำงานได้ และขั้นตอนที่มีประโยชน์ถัดไป

ห้าเส้นทางที่นำไปใช้ได้จริง

เริ่มต้นด้วยผลลัพธ์ ไม่ใช่รายการ endpoint

Selected: Plan release jobs

การทดลองใช้ API เป็นเวลา 14 วันของคุณ

เปลี่ยนจากการส่งคำขอครั้งแรกไปสู่งานที่มีคุณค่าและยั่งยืน

เป้าหมายไม่ใช่การเข้าชมทุกหน้าผลิตภัณฑ์ แต่คือการทำงานด้วย API ที่มีการยืนยันตัวตนอย่างมีประโยชน์ให้เสร็จสิ้น กลับมาอีกครั้งในวันอื่น และจากไปพร้อมกับชุดข้อมูลหรือเวิร์กโฟลว์แอปพลิเคชันที่ทำซ้ำได้

ตรวจสอบความคืบหน้าของ API

วัน 0

พิสูจน์การเข้าถึง

สร้างคีย์, ดำเนินการคำขอที่ผ่านการพิสูจน์ตัวตนหนึ่งครั้ง และบันทึกการตอบสนองครั้งแรกพร้อมกับเมทาดาตา

เปิดขั้นตอน →

วัน 1-2

ทำให้คำขอมีความน่าเชื่อถือ

แก้ไขปัญหาการยืนยันตัวตนหรือตัวกรอง และเปลี่ยนสคริปต์แรกให้เป็นงานที่ตั้งชื่อและทำซ้ำได้

เปิดขั้นตอน →

วัน 3-4

เพิ่มเวลาการประกาศ

ใช้ปฏิทินเป็นกลุ่ม endpoint ที่สองและกำหนดตารางการรัน API ที่มีประโยชน์ครั้งต่อไป

เปิดขั้นตอน →

วัน 5-7

สร้างผลลัพธ์การวิจัย

เพิ่มความคาดหวังหรือกลุ่มเล็กๆ ของชุดข้อมูล macro จากนั้นสร้างการเปรียบเทียบ, ตาราง หรือ scorecard ที่บันทึกไว้หนึ่งรายการ

เปิดขั้นตอน →

วันที่ 8-10

อัปเดตอัตโนมัติ

เลือก REST, SSE ที่กำหนดเวลาไว้ หรือ webhooks และดำเนินการรัน API ที่ประสบความสำเร็จอีกครั้งในวันอื่น

เปิดขั้นตอน →

วัน 11-13

เสริมความแข็งแกร่งให้ไคลเอนต์

เพิ่มการกำหนดเวลาหมดเวลา (timeouts), การลองใหม่แบบจำกัดจำนวน (bounded retries), การตรวจสอบความถูกต้องของการตอบสนอง, การบันทึกข้อมูลที่ปลอดภัยต่อข้อมูลประจำตัว และการตรวจสอบข้อมูลที่ล้าสมัย

เปิดขั้นตอน →

วัน 14

ตรวจสอบหลักฐาน

ยืนยันว่า API ให้งานที่ทำซ้ำได้ซึ่งทีมของคุณจะรักษาไว้ จากนั้นเลือกชุดข้อมูลหรือเวิร์กโฟลว์แอปพลิเคชันถัดไป

เปิดขั้นตอน →

Scheduled workflow

Plan around confirmed releases

The calendar tells your scheduler when a release is expected. Your job can then fetch the full announcement record after publication instead of polling every series continuously.

15 minutes Core workflow ปฏิทินการประกาศ

ตัวอย่างการทำงาน

เก็บคีย์ของคุณไว้ใน FXMD_API_KEY; ห้ามวางลงใน source control โดยเด็ดขาด

from datetime import date, timedelta
import os
import requests

events = requests.get(
    "https://api.fxmacrodata.com/v1/calendar/eur",
    params={
        "api_key": os.environ["FXMD_API_KEY"],
        "start_date": date.today().isoformat(),
        "end_date": (date.today() + timedelta(days=14)).isoformat(),
        "timezone": "UTC",
    },
    timeout=20,
).json()["data"]
print(events[:3])

ผลลัพธ์ที่คาดหวัง: Upcoming EUR releases with dates, times, indicator paths, and confirmation fields that your scheduler can evaluate before creating a job.

เมื่อสคริปต์แรกกลายเป็นระบบจริง

การแก้ไขปัญหาและคำแนะนำระดับ production

ใช้คู่มือเหล่านี้เมื่อการตอบสนองล้มเหลว, ไม่คืนค่าข้อมูล หรือต้องการการควบคุมระดับ production เช่น การทำแคช, การกำหนดเวลาหมดเวลา, การลองใหม่ และการส่งเหตุการณ์

คู่มือใช้เมื่อเริ่ม
วินิจฉัยการตอบกลับที่ล้มเหลวหรือว่างเปล่า แยกปัญหาการยืนยันตัวตน, การเข้าถึง, เส้นทาง, การจำกัดอัตรา และความพร้อมใช้งานของข้อมูล โดยไม่เปิดเผยคีย์ของคุณ เปิดคู่มือ →
ทำให้ไคลเอนต์ API พร้อมสำหรับการผลิต เพิ่มการกำหนดเวลาหมดเวลา (timeouts), การลองใหม่แบบจำกัดจำนวน (bounded retries), การทำแคช, การร้องขอแบบมีเงื่อนไข และรูปแบบการส่งข้อมูลที่เหมาะสม เปิดคู่มือ →