เส้นฐานสามข้อของการผลิตเนื้อหา
- ลงมือทำได้สำคัญกว่าอ่านเพลิน เป้าหมายของบทเรียนแต่ละชิ้นคือให้ผู้อ่านทำงานหนึ่งอย่างให้สำเร็จ (ตั้งค่าสิทธิ์ API วางสภาพแวดล้อม Testnet ตั้งค่า IP Whitelist) ไม่ใช่การอธิบายแนวคิดเชิงนามธรรมลอย ๆ
- วางคำเตือนความเสี่ยงไว้ข้างหน้า ไม่ใช่เชิงอรรถท้ายเรื่อง ขั้นตอนที่เกี่ยวกับบัญชีจริง คำเตือนความปลอดภัยและคำอธิบายข้อจำกัดสิทธิ์จะปรากฏก่อนคำสั่งปฏิบัติ ไม่ใช่ซ่อนอยู่ใน "ข้อจำกัดความรับผิด" ท้ายหน้า
- ไม่สร้างความคาดหวังเรื่องผลตอบแทนเด็ดขาด เราวิเคราะห์โครงสร้างค่าธรรมเนียม คำนวณผลของระยะห่างกริดต่อกำไร แยกแยะต้นทุนแฝงของ funding rate แต่เราจะไม่พูดว่า "ใช้กลยุทธ์นี้แล้วคุณจะได้กำไรเท่าไร"
การตรวจสอบข้ามกับเอกสารทางการของ Binance
รายละเอียดเชิงเทคนิคในเนื้อหาของ BotForge ต้องผ่านกระบวนการตรวจสอบต่อไปนี้ก่อนเผยแพร่:
- ที่อยู่ API endpoint: เทียบทีละรายการกับเวอร์ชันปัจจุบันของเอกสาร API ทางการของ Binance (
binance-docs.github.io) หากบทเรียนอ้างถึง/api/v3/orderผู้ตรวจสอบต้องยืนยันว่ารายการพารามิเตอร์ กฎ rate limit และรูปแบบการตอบกลับของ endpoint นั้นไม่มีการเปลี่ยนแปลง - ค่าสิทธิ์ที่เลือกได้: ประเภทสิทธิ์ที่เลือกได้ตอนสร้าง API Key (Enable Reading / Enable Spot & Margin Trading / Enable Withdrawals / Enable Futures ฯลฯ) ยึดตามตัวเลือกจริงในหน้าจัดการบัญชี Binance ภาพหน้าจอในบทเรียนต้องระบุวันที่ที่จับภาพ
- ข้อมูลค่าธรรมเนียม: ขั้นบันไดค่าธรรมเนียม (อัตรา Maker/Taker ตามระดับ VIP) ยึดตามประกาศปัจจุบันในหน้าค่าธรรมเนียมของ Binance เมื่ออ้างค่าธรรมเนียมในบทเรียนจะใช้รูปแบบ "อัตราที่ประกาศ ณ YYYY-MM" และเตือนผู้อ่านว่าค่าธรรมเนียมอาจปรับเปลี่ยนได้ทุกเมื่อ
- ที่อยู่ Testnet: ความพร้อมใช้งานของ Spot Testnet (
testnet.binance.vision) และ Futures Testnet (testnet.binancefuture.com) ต้องเข้าทดสอบจริงเพื่อยืนยันก่อนเผยแพร่
มาตรฐานการตรวจสอบตัวอย่างโค้ด
โค้ด Python / Node.js ที่ปรากฏในบทเรียนต้องผ่านการตรวจสอบต่อไปนี้ก่อนเผยแพร่:
- ตำแหน่ง API Secret ในโค้ดต้องใช้ตัวแทน
YOUR_API_SECRET_HEREห้ามมีคีย์จริงใด ๆ แม้แต่คีย์ทดสอบที่ยกเลิกไปแล้ว - โค้ดที่เกี่ยวกับการส่งคำสั่งซื้อขายให้เชื่อมต่อ endpoint ของ Testnet เป็นค่าเริ่มต้น หากต้องแสดงความต่างของ endpoint บัญชีจริง ให้ระบุด้วยคอมเมนต์พร้อมแนบคำเตือนความเสี่ยง
- โค้ดควรมีการจัดการข้อผิดพลาดพื้นฐาน (ตรวจ HTTP status code จัดการการตอบกลับ rate limit ของ API) ไม่เผยแพร่ตัวอย่างแบบ "happy path only"
- ต้องระบุเวอร์ชันไลบรารีที่ใช้ (เช่น
python-binance==1.0.x) เพื่อหลีกเลี่ยงการที่ผู้อ่านเรียกใช้งานล้มเหลวเพราะความต่างของเวอร์ชัน
เงื่อนไขที่กระตุ้นให้ต้องอัปเดตเนื้อหา
เมื่อเกิดเหตุการณ์ต่อไปนี้ หน้าบทเรียนที่เกี่ยวข้องจะถูกทำเครื่องหมาย "รออัปเดต" และแก้ไขให้เสร็จภายใน 72 ชั่วโมง:
- Binance ปรับเวอร์ชัน API endpoint หรือยกเลิก endpoint เก่า
- ตัวเลือกสิทธิ์ของ API Key เปลี่ยนแปลง (เช่น เพิ่มหรือลบประเภทสิทธิ์บางอย่าง)
- โครงสร้างขั้นบันไดค่าธรรมเนียมมีการปรับ
- โดเมนหรือขอบเขตฟังก์ชันของ Testnet เปลี่ยนแปลง
- ผู้อ่านแจ้งกลับมาว่าขั้นตอนปฏิบัติไม่ตรงกับหน้าจอจริง
ขอบเขตของเนื้อหาที่ใช้ AI ช่วย
เว็บนี้ใช้เครื่องมือ AI ช่วยในขั้นตอนต่อไปนี้: การจัดโครงร่างฉบับร่าง การเทียบศัพท์เทคนิคหลายภาษา และการจัดรูปแบบโค้ดให้เป็นมาตรฐาน แต่เนื้อหาทั้งหมดที่เกี่ยวกับการตั้งค่าสิทธิ์ API ขั้นตอนปฏิบัติด้านความปลอดภัย และคำเตือนความเสี่ยง ต้องผ่านการตรวจสอบโดยมนุษย์ก่อนเผยแพร่ กล่าวคือ BotForge Editorial Team จะลงมือเดินผ่านขั้นตอนปฏิบัติบน Testnet หรือสภาพแวดล้อมแซนด์บ็อกซ์ด้วยตัวเอง เนื้อหาที่ AI สร้างขึ้นหากเกี่ยวข้องกับตัวเลขค่าธรรมเนียม ที่อยู่ endpoint หรือพารามิเตอร์สิทธิ์ ต้องย้อนกลับไปตรวจทีละข้อกับเอกสารทางการของ Binance ก่อนจึงจะเผยแพร่ได้
ช่องทางแจ้งแก้ไขและข้อเสนอแนะ
หากคุณพบว่าที่อยู่ endpoint ในบทเรียนใช้ไม่ได้ คำอธิบายสิทธิ์ไม่ตรงกับของจริง ตัวอย่างโค้ดรันไม่ได้ หรือคำแนะนำด้านความปลอดภัยมีช่องโหว่ กรุณาแจ้งเราผ่านช่องทางติดต่อในเว็บ ข้อผิดพลาดที่เกี่ยวกับความเสี่ยงด้านความปลอดภัย (เช่น ขั้นตอนใดอาจทำให้คีย์รั่วไหล) จะได้รับการดำเนินการและเผยแพร่ฉบับแก้ไขภายใน 24 ชั่วโมง