วิธีการสร้างคีย์ API สำหรับสปอต

Last updated: 8 ส.ค. 2568

คีย์ API เป็นหนึ่งในส่วนประกอบหลักของของระบบยืนยันตัวตนและความปลอดภัยของ API โดยทำหน้าที่เสมือนชื่อผู้ใช้และรหัสผ่านของบัญชี Kraken ของคุณในรูปแบบ API

จำเป็นต้องใช้คีย์ API เพื่อเรียกใช้ปลายทางของ API แบบเฉพาะบัญชี (ส่วนตัว) เช่น ข้อมูลบัญชี การซื้อขาย และ การจัดหาเงินทุน และ การหารายได้ ไม่จำเป็นต้องใช้คีย์ API เพื่อเรียกใช้ปลายทางของ API ข้อมูลตลาด (สาธารณะ) เนื่องจากปลายทางของข้อมูลตลาดไม่ได้เชื่อมโยงกับบัญชี Kraken ใด ๆ โดยเฉพาะ

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

  • การสร้างคีย์ API

  • การกำหนดค่าคีย์ API (การอนุญาต/การตั้งค่า)

  • การใช้คีย์ API

  • การยืนยันตัวตน 2 ขั้นตอน (2FA) สำหรับคีย์ API

การสร้างคีย์ API

46.png
  • เลือกแท็บ API และคลิก สร้างคีย์ API

46.png

การกำหนดค่าคีย์ API

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

API_Key_Settings.png

คำอธิบายคีย์

คำอธิบายคีย์ คือชื่อของคีย์ API และสามารถเป็นอะไรก็ได้ที่คุณต้องการ ตราบใดที่คำอธิบายนั้น ไม่ซ้ำกัน (แตกต่างจากคำอธิบายของคีย์ API อื่น ๆ ในบัญชีเดียวกัน)

โดยค่าเริ่มต้น ระบบจะกรอกคำอธิบายของคีย์เป็นข้อความลักษณะดังนี้ "api-key-1605316109249". คำอธิบายเริ่มต้นนี้สามารถเก็บไว้ หรือเปลี่ยนเป็นชื่อที่มีความหมายมากขึ้น (เช่น "คีย์การซื้อขาย" "คีย์การจัดการบัญชี" "คีย์ API Python 6" หรือ "คีย์แอปมือถือ" เป็นต้น)

สิทธิ์การใช้งานของคีย์

สิทธิ์การใช้งานของคีย์จะกำหนดว่าบัญชีใดสามารถเรียกใช้ปลายทางของ API แบบเฉพาะบัญชี (ส่วนตัว) ได้:

เงินทุน

  • การสอบถามเงินทุน เป็นสิ่งจำเป็นสำหรับปลายทางของ API ที่สอบถามข้อมูลยอดเงินบัญชี เช่น ยอดคงเหลือ และ ยอดการซื้อขาย

  • การฝากเงิน เป็นสิ่งจำเป็นสำหรับปลายทางของ API ที่เกี่ยวข้องกับการฝาก เช่น วิธีการฝาก และ ที่อยู่การฝาก

  • การถอนเงิน เป็นสิ่งจำเป็นสำหรับปลายทางของ API ที่เกี่ยวข้องกับการถอน เช่น ข้อมูลการถอน การถอน และ ยกเลิกการถอน

คำสั่งซื้อ & การซื้อขาย

  • การสอบถามคำสั่งซื้อและการซื้อขายที่เปิดอยู่ เป็นสิ่งจำเป็นสำหรับปลายทางของ API ที่สอบถามคำสั่งซื้อที่มีอยู่และสถานะมาร์จิ้น เช่น คำสั่งซื้อที่เปิดอยู่ การสอบถามคำสั่งซื้อ และ สถานะที่เปิดอยู่

  • การสอบถามคำสั่งซื้อและการซื้อขายที่ปิดแล้ว เป็นสิ่งจำเป็นสำหรับปลายทางที่สอบถามคำสั่งซื้อที่ปิด/ยกเลิกก่อนหน้านี้และสถานะมาร์จิ้น เช่น คำสั่งซื้อที่ปิดแล้ว การสอบถามคำสั่งซื้อ และ การสอบถามการซื้อขาย

  • แก้ไขคำสั่งซื้อ เป็นสิ่งจำเป็นสำหรับการใช้งานปลายทางของการซื้อขาย ที่ใช้ส่งคำสั่งใหม่ เช่น เพิ่มคำสั่งซื้อ แก้ไขคำสั่งซื้อ และ เพิ่มชุดคำสั่งซื้อ

  • ยกเลิก/ปิดคำสั่งซื้อ เป็นสิ่งจำเป็นสำหรับปลายทางของ API ที่ยกเลิกคำสั่งซื้อที่เปิดอยู่หรือรอดำเนินการ เช่น ยกเลิกคำสั่งซื้อ, ยกเลิกทั้งหมด และ ยกเลิกชุดคำสั่งซื้อ

อื่นๆ

  • สอบถามรายการบัญชีแยกประเภท เป็นสิ่งจำเป็นสำหรับปลายทางของ API ที่ดึงประวัติข้อมูลของบัญชีจากสมุดบัญชีแยกประเภท เช่น รายการบัญชี และ สอบถามรายการบัญชี

  • การส่งออกข้อมูล เป็นสิ่งจำเป็นสำหรับปลายทางที่ส่งออก (ดาวน์โหลด) บัญชีเล่ม เช่น เพิ่มการส่งออก ดึงการส่งออก สถานะการส่งออก และ ลบการส่งออก

  • จำเป็นต้องเปิดสิทธิ์การเข้าถึง WebSockets API เพื่อดึง Token การยืนยันตัวตนสำหรับ WebSocket API ผ่าน ปลายทางดึง Token WebSockets

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

การกำหนดสิทธิ์อย่างเหมาะสมจะทำให้ API ฝั่งที่มีการเรียกใช้งานสามารถทำการซื้อขายสำหรับบัญชีได้ แต่จะป้องกันไม่ให้ API ฝั่งที่มีการเรียกใช้งานเข้าถึงข้อมูลบัญชีใด ๆ หรือทำการจัดหาเงินทุนได้

การตั้งค่าเพิ่มเติม

การตั้งค่าคีย์ API ที่เหลือใช้สำหรับการกำหนดค่าขั้นสูงเท่านั้น โดยทั่วไปสามารถคงค่าเริ่มต้นไว้ได้:

  • กรอบเวลาที่ยอมรับค่า Nonce เป็นการตั้งค่าที่ช่วยแก้ปัญหาความล่าช้าหรือความไม่เสถียรของเครือข่าย ซึ่งอาจทำให้คำขอ API มาถึงไม่ตรงเวลา โดยการให้กรอบเวลาสั้น ๆ (เช่น 1 วินาที หรือ 10 วินาที เป็นต้น) ในช่วงเวลาที่คำขอ API ที่มี Nonce ไม่ถูกต้อง (ค่า Nonce ต่ำกว่าค่าที่ใช้ก่อนหน้านี้) จะไม่ทำให้เกิดข้อผิดพลาด Nonce ไม่ถูกต้อง 

  • ที่อยู่ IP ที่อนุญาต เป็นฟีเจอร์ด้านความปลอดภัยที่จำกัดการใช้คีย์ API ให้ใช้ได้เฉพาะจากที่อยู่ IP ของฝั่งลูกค้าที่กำหนดไว้เท่านั้น

  • การหมดอายุของคีย์ สามารถใช้เพื่อสร้างคีย์ API ที่ทำงานได้เฉพาะในระยะเวลาที่กำหนด เช่น คีย์ที่ใช้ได้เพียง 1 สัปดาห์เท่านั้น

  • วันที่/เวลาที่เริ่มต้น/สิ้นสุดการค้นหา เป็นการตั้งค่าที่จำกัดการร้องขอข้อมูลบัญชีในอดีตให้เป็นกรอบเวลาที่เฉพาะเจาะจง เช่น คีย์ที่สามารถดึงประวัติการซื้อขายจากปีนี้ได้ แต่ไม่สามารถดึงจากปีที่แล้วได้

เมื่อการตั้งค่าคีย์ API ถูกกำหนดอย่างเหมาะสม คีย์ API ใหม่สามารถสร้างได้โดยการคลิกที่ปุ่ม สร้างคีย์

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

การใช้คีย์ API

คีย์ API ประกอบด้วยคู่คีย์สาธารณะและคีย์ส่วนตัว ซึ่งทั้งสองต้องถูกจัดเตรียมให้กับซอฟต์แวร์ API ฝั่งที่มีการเรียกใช้งาน

API_ExampleKey1Generated_03122021.png

คีย์ API สามารถจัดเตรียมให้ได้หลายวิธี เช่น:

  • คู่คีย์สามารถคัดลอกและวางเป็นข้อความธรรมดาโดยตรงลงในโค้ด API ฝั่งที่มีการเรียกใช้งาน ตัวอย่าง: วิธีที่ใช้โดย PHP API ฝั่งที่มีการเรียกใช้งานของเรา

  • คู่คีย์สามารถคัดลอกและวางลงในไฟล์ข้อความธรรมดาที่ API ฝั่งที่มีการเรียกใช้งานสามารถเข้าถึงได้ ตัวอย่าง: วิธีที่ใช้โดย API ฝั่งที่มีการเรียกใช้ผ่านบรรทัดคำสั่งของเรา

หมายเหตุ: คีย์ส่วนตัวยังเป็นที่รู้จักในชื่อ รหัสลับ API (หรือเพียงแค่รหัสลับ) โดยซอฟต์แวร์ API ฝั่งที่มีการเรียกใช้งานบางตัว

2FA สำหรับคีย์ API

คีย์ API ให้วิธีการที่ปลอดภัยในการตรวจสอบการเข้าถึง API ไปยังบัญชี Kraken แต่ความปลอดภัยของคีย์สามารถเพิ่มขึ้นได้อีกโดยเพิ่มการยืนยัน 2 ขั้นตอน (2FA)

การเพิ่ม 2FA ให้กับคีย์ API ที่มีอยู่แล้วสามารถทำได้ผ่านหน้าความปลอดภัย และสามารถใช้รหัสผ่านแบบคงที่หรือ Google Authenticator

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

อ่านเพิ่มเติมเกี่ยวกับ วิธีการทำงานของ 2FA สำหรับคีย์ API ที่นี่

ต้องการความช่วยเหลือเพิ่มเติมหรือไม่