ข้ามไปที่เนื้อหา

API การรับรองความถูกต้องของบล็อกเชน

Auth API เป็น API ที่ออกโทเค็นที่จำเป็นสำหรับการตรวจสอบสิทธิ์เมื่อใช้ Hive Blockchain API.

การออกโทเค็นการตรวจสอบสิทธิ์

นี่คือ API ที่ออกโทเค็นการรับรองความถูกต้องที่จำเป็นสำหรับการใช้ API บริการบล็อกเชน

URL การร้องขอ

ลิงก์สด https://bc-platform-auth.withhive.com/v2/auth-token
ลิงก์ Sandbox https://sandbox-bc-platform-auth.withhive.com/v2/auth-token
วิธีการ HTTP POST
ประเภทเนื้อหา application/json

ร่างคำขอ

ชื่อฟิลด์ คำอธิบาย ประเภท จำเป็น
id ID ที่ใช้เพื่อรับโทเค็นการตรวจสอบสิทธิ์ string Y
secretKey รหัสลับที่จำเป็นสำหรับการใช้งาน API string Y

การตอบสนอง

ชื่อฟิลด์ คำอธิบาย ประเภท
code รหัสผลลัพธ์การเรียก API, 0: สำเร็จ number
message ข้อความผลลัพธ์ string
data ค่าการตอบกลับของ API json
data.accessToken โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นสำหรับการใช้งาน API string
data.refreshToken โทเค็นที่สามารถใช้เพื่อต่ออายุ accessToken เมื่อหมดอายุ string

ตัวอย่างคำขอ

curl -X 'POST' 
  'https://sandbox-bc-platform-auth.withhive.com/v2/auth-token' 
  -H 'accept: */*' 
  -H 'Content-Type: application/json' 
  -d '{
  "id": "test",
  "secretKey": "1234"
}'

ตัวอย่างการตอบกลับ

{
  "code": 0,
  "message": "success",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNvbS5jb20ydXMuYzJ4d2FsbGV0Lmdsb2JhbC5ub3JtYWwiLCJyb2xlIjoib3BlcmF0b3IiLCJhZGRyZXNzIjoieHBsYTE5cHdkYTJsdXQ5eGFlZnI4Z3NtZ2t0dXFldzkwc2M1YWpseGhrZyIsImlhdCI6MTY2NzM4MjY5NSwiZXhwIjoxNjY3NDY5MDk1fQ.xRq3ew5GAcn0zEcTEyRAXByjAbhgRQb3aWqaxy_iQ68",
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNvbS5jb20ydXMuYzJ4d2FsbGV0Lmdsb2JhbC5ub3JtYWwiLCJyb2xlIjoib3BlcmF0b3IiLCJhZGRyZXNzIjoieHBsYTE5cHdkYTJsdXQ5eGFlZnI4Z3NtZ2t0dXFldzkwc2M1YWpseGhrZyIsImlhdCI6MTY2NzM4MjY5NSwiZXhwIjoxNjY3OTg3NDk1fQ.s8dL3tCwdbHUTQnWqAWbDSaGumKF3Jc_aYXVJUp1VxQ"
  }
}

การออกใหม่ของโทเค็น

นี่คือ API ที่ออกโทเค็นการรับรองความถูกต้องที่จำเป็นในการใช้ API บล็อกเชน Hive โดยใช้ Refresh Token ที่ได้รับพร้อมกับโทเค็นการรับรองความถูกต้องเมื่อมันหมดอายุ

URL การร้องขอ

URL สด https://bc-platform-auth.withhive.com/v2/refresh-token
URL แซนด์บ็อกซ์ https://sandbox-bc-platform-auth.withhive.com/v2/refresh-token
วิธีการ HTTP POST
ประเภทเนื้อหา application/json

ส่วนหัวคำขอ

ชื่อฟิลด์ คำอธิบาย ประเภท จำเป็น
Authorization refreshToken ที่จำเป็นสำหรับการเรียก API string Y

การตอบกลับ

ชื่อฟิลด์ คำอธิบาย ประเภท
code รหัสผลลัพธ์การเรียก API, 0: สำเร็จ หมายเลข
message ข้อความผลลัพธ์ สตริง
data ค่าการตอบสนองของ API json
data.accessToken โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นสำหรับการใช้งาน API สตริง
data.refreshToken โทเค็นที่สามารถใช้ในการต่ออายุ accessToken เมื่อหมดอายุ สตริง

ตัวอย่างคำขอ

curl -X 'POST' 
  'https://test-bc-platform-auth.withhive.com/v2/refresh-token' 
  -H 'accept: */*' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXlObyI6MSwiaWQiO...' 
  -d ''

ตัวอย่างการตอบสนอง

{
  "code": 1000,
  "message": "success",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNvbS5jb20ydXMuYzJ4d2FsbGV0Lmdsb2JhbC5ub3JtYWwiLCJyb2xlIjoib3BlcmF0b3IiLCJhZGRyZXNzIjoieHBsYTE5cHdkYTJsdXQ5eGFlZnI4Z3NtZ2t0dXFldzkwc2M1YWpseGhrZyIsImlhdCI6MTY2NzQ3MTIwMSwiZXhwIjoxNjY3NTU3NjAxfQ.icFnROeEU7RI0FvEdPR5Oa26YqEihwcBN-KT_n_iq_o",
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNvbS5jb20ydXMuYzJ4d2FsbGV0Lmdsb2JhbC5ub3JtYWwiLCJyb2xlIjoib3BlcmF0b3IiLCJhZGRyZXNzIjoieHBsYTE5cHdkYTJsdXQ5eGFlZnI4Z3NtZ2t0dXFldzkwc2M1YWpseGhrZyIsImlhdCI6MTY2NzQ3MTIwMSwiZXhwIjoxNjY4MDc2MDAxfQ.fclh8qVxLRG0Z1Fn2KRtW7Dmm6KFY5H4jvRSroy-mag"
  }
}