ข้ามไปที่เนื้อหา
การเชื่อมต่อสำหรับ Agent

เชื่อม AiTopNews เข้ากับ Agent ของคุณ

ช่องทาง 3 แบบ (MCP · RSS · API) อ่านข้อมูลชุดเดียวกัน: คัดสรร อันดับความร้อนแรง รายวัน รายสัปดาห์ และรายเดือน เลือกแบบที่เครื่องมือของคุณรองรับ ทั้งหมดไม่ระบุตัวตนและอ่านอย่างเดียว ไม่ต้องสมัครและไม่ต้องใช้ API Key

บริการทำงานปกติเวอร์ชัน 4.0.0ไม่ระบุตัวตน อ่านอย่างเดียว · ไม่ใช้คีย์
REST API · 4.0.0

GET แบบไม่ระบุตัวตน พร้อมใช้

ไม่ต้องใช้โทเคน คำขอข้ามโดเมนจากเบราว์เซอร์ curl และ HTTP client มาตรฐานของทุกภาษาก็เรียกได้ เส้นทางเริ่มด้วย /api/v1 ฟิลด์และรหัสข้อผิดพลาดอยู่ใน OpenAPI

คำขอแรก
curl --compressed 'https://aitopnews.wiki/api/v1/items?mode=selected&window=24h&limit=20'

กรองตามหมวด

เพิ่ม category ในคำขอ items เพื่อเอาเฉพาะหมวดเดียว ละไว้เพื่อเอาทั้งหมด รายการมีค่าหมวดชุดเดียวกัน

หมวดพารามิเตอร์คำขอ
โมเดล AIcategory=ai-models
ผลิตภัณฑ์ AIcategory=ai-products
ข่าวอุตสาหกรรมcategory=industry
งานวิจัยcategory=paper
บทสอนcategory=tip
ความเห็นcategory=opinion

เบากว่า และเร็วกว่า

  1. 01
    เปิดการบีบอัด

    เพิ่ม --compressed ใน curl หรือเปิด gzip หรือ br ในไคลเอนต์อื่น JSON ที่บีบอัดแล้วเหลือหนึ่งในสี่ถึงหนึ่งในแปดของขนาดเดิม

  2. 02
    ส่ง ETag มาด้วย

    เก็บ ETag จากคำตอบแล้วส่ง If-None-Match ในครั้งถัดไป เนื้อหาที่ไม่เปลี่ยนจะตอบ 304 โดยไม่มีเนื้อหา

  3. 03
    ดึงข้อมูลให้ถูกจังหวะ

    items และอันดับความร้อนแรงไม่เกินนาทีละครั้ง รายวันครั้งเดียวหลัง ทุกวันเวลา 08:00 รายสัปดาห์และรายเดือนครั้งเดียวหลังแต่ละฉบับ เมื่อย้อนหน้าให้หยุดที่รายการที่มีอยู่แล้ว

ความถี่ที่เนื้อหาเปลี่ยน: รายการเข้ามาทั้งวัน คัดสรรเปลี่ยนไม่กี่สิบครั้งต่อวัน ส่วนรายวัน รายสัปดาห์ และรายเดือนออกอย่างละครั้ง (เวลาปักกิ่ง)

ปลายทาง

เส้นทางใช้ทำอะไรบ่อยแค่ไหน
รายการ
/api/v1/itemsคัดสรรหรือทุกรายการของ 7 วันที่ผ่านมา กรองตามหมวด ช่วงเวลา และคำค้นได้ไม่เกินนาทีละครั้ง
อันดับความร้อนแรงและเหตุการณ์
/api/v1/hot-topicsอันดับความร้อนแรงปัจจุบัน สิบอันดับแรกไม่เกินนาทีละครั้ง
/api/v1/stories/{publicId}ไทม์ไลน์ของเหตุการณ์หนึ่ง ไดเจสต์ AI และเหตุการณ์ที่เกี่ยวข้องเมื่อจำเป็น
รายวัน
/api/v1/dailies/latestรายวันฉบับล่าสุดครั้งเดียวหลัง ทุกวันเวลา 08:00
/api/v1/dailies/{date}รายวันของวันที่ระบุ การถอนเนื้อหาจะลบการอ้างอิงเมื่อแคชหมดอายุ ตรวจ ETag ก่อนใช้
/api/v1/dailiesดัชนีวันที่ของรายวันวันละครั้ง
รายสัปดาห์และรายเดือน
/api/v1/weeklies/latestรายสัปดาห์ฉบับล่าสุด: เรื่องนำ ภาพรวม และไฮไลต์ของสัปดาห์แยกตามหมวดครั้งเดียวหลัง ทุกวันจันทร์เวลา 10:00
/api/v1/weeklies/{week}สัปดาห์ที่ระบุ เช่น ISO 2026-W39 การถอนเนื้อหาจะลบการอ้างอิงเมื่อแคชหมดอายุ ตรวจ ETag ก่อนใช้
/api/v1/weekliesดัชนีรายสัปดาห์สัปดาห์ละครั้ง
/api/v1/monthlies/latestรายเดือนฉบับล่าสุดครั้งเดียวหลัง วันที่ 1 ของทุกเดือนเวลา 10:30
/api/v1/monthlies/{month}เดือนที่ระบุ เช่น 2026-09เมื่อแคชหมดอายุ ตรวจ ETag ก่อนใช้
/api/v1/monthliesดัชนีรายเดือนเดือนละครั้ง
สำหรับผู้ช่วย AI
/api/v1/agentคำแนะนำการใช้งานสำหรับ Agent ที่อยู่ที่ระบุไว้คืน Markdown ที่จัดรูปแบบแล้วเมื่อจำเป็น
ซิงก์คัดสรรทั้งหมด
/api/v1/selected/snapshotคัดสรรทั้งหมดในปัจจุบัน แบ่งหน้าในครั้งเดียวเฉพาะครั้งแรก
/api/v1/selected/changesคัดสรรที่เพิ่มใหม่ แก้ไข และถูกถอนหลังจากนั้นทุกไม่กี่นาที

วิธีใช้ที่พบบ่อย

bash
# ครั้งแรก: เก็บ ETag จากหัวข้อตอบกลับ\n# หลังจากนั้นไม่เกินนาทีละครั้ง พร้อมส่ง ETag มาด้วย 304 หมายถึงไม่มีการเปลี่ยนแปลง\n
curl --compressed -i 'https://aitopnews.wiki/api/v1/items?mode=selected&window=24h&limit=20'
curl --compressed -i -H 'If-None-Match: <last ETag>' 'https://aitopnews.wiki/api/v1/items?mode=selected&window=24h&limit=20'

เมื่อต้องย้อนหน้า ให้ส่ง page.nextCursor กลับมาเป็น cursor และหยุดที่รายการที่มีอยู่แล้ว ไม่ต้องไล่ย้อนเจ็ดวันใหม่ทุกครั้ง

เมื่อเกิดข้อผิดพลาด

400
พารามิเตอร์ผิด: แก้ตาม OpenAPI และ code ที่คืนมา อย่าขยายคำค้นเอง ถ้า cursor ใช้ไม่ได้หรือหลุดช่วงเวลา จะคืน invalid_cursor ให้เริ่มจากหน้าแรก
409
snapshot_required: ข้อมูลเพิ่มเติมต่อเนื่องไม่ได้อย่างปลอดภัย ให้ดึงสแนปช็อตเต็มชุดใหม่
429
คำขอถี่เกินไป: รอตาม Retry-After และอย่ารีทรายซ้ำพร้อมกัน
5xx
ถอยแบบทวีคูณและใช้ผลลัพธ์ล่าสุดที่ได้ บริการสาธารณะไม่รับประกัน SLA

เรียกได้แบบไม่ระบุตัวตนไม่เท่ากับได้รับอนุญาตทุกกรณี ดูข้อกำหนดการใช้งาน