เชื่อม AiTopNews เข้ากับ Agent ของคุณ
ช่องทาง 3 แบบ (MCP · RSS · API) อ่านข้อมูลชุดเดียวกัน: คัดสรร อันดับความร้อนแรง รายวัน รายสัปดาห์ และรายเดือน เลือกแบบที่เครื่องมือของคุณรองรับ ทั้งหมดไม่ระบุตัวตนและอ่านอย่างเดียว ไม่ต้องสมัครและไม่ต้องใช้ API Key
GET แบบไม่ระบุตัวตน พร้อมใช้
ไม่ต้องใช้โทเคน คำขอข้ามโดเมนจากเบราว์เซอร์ curl และ HTTP client มาตรฐานของทุกภาษาก็เรียกได้ เส้นทางเริ่มด้วย /api/v1 ฟิลด์และรหัสข้อผิดพลาดอยู่ใน OpenAPI
curl --compressed 'https://aitopnews.wiki/api/v1/items?mode=selected&window=24h&limit=20'กรองตามหมวด
เพิ่ม category ในคำขอ items เพื่อเอาเฉพาะหมวดเดียว ละไว้เพื่อเอาทั้งหมด รายการมีค่าหมวดชุดเดียวกัน
| หมวด | พารามิเตอร์คำขอ |
|---|---|
| โมเดล AI | category=ai-models |
| ผลิตภัณฑ์ AI | category=ai-products |
| ข่าวอุตสาหกรรม | category=industry |
| งานวิจัย | category=paper |
| บทสอน | category=tip |
| ความเห็น | category=opinion |
เบากว่า และเร็วกว่า
- 01เปิดการบีบอัด
เพิ่ม --compressed ใน curl หรือเปิด gzip หรือ br ในไคลเอนต์อื่น JSON ที่บีบอัดแล้วเหลือหนึ่งในสี่ถึงหนึ่งในแปดของขนาดเดิม
- 02ส่ง ETag มาด้วย
เก็บ ETag จากคำตอบแล้วส่ง If-None-Match ในครั้งถัดไป เนื้อหาที่ไม่เปลี่ยนจะตอบ 304 โดยไม่มีเนื้อหา
- 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 | คัดสรรที่เพิ่มใหม่ แก้ไข และถูกถอนหลังจากนั้น | ทุกไม่กี่นาที |
วิธีใช้ที่พบบ่อย
# ครั้งแรก: เก็บ 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
เรียกได้แบบไม่ระบุตัวตนไม่เท่ากับได้รับอนุญาตทุกกรณี ดูข้อกำหนดการใช้งาน