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

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

API การตรวจสอบสิทธิ์จะออกโทเค็นการตรวจสอบสิทธิ์ที่จำเป็นสำหรับการใช้ Hive Blockchain API และ Blockchain Open 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 ค่ารหัสสำหรับออกโทเค็นการตรวจสอบสิทธิ์ string Y
secretKey รหัสลับที่จำเป็นในการใช้ API string Y

การตอบกลับ

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

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

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 ที่ใช้ refresh token ที่ออกโดย token การตรวจสอบสิทธิ์ก่อนหน้านี้เพื่อออก token การตรวจสอบสิทธิ์ใหม่ที่จำเป็นในการใช้ API บริการบล็อกเชน (Blockchain Open APIs, Hive Blockchain APIs) เมื่อ token การตรวจสอบสิทธิ์ก่อนหน้านี้หมดอายุ

URL การร้องขอ

ลิงก์สด https://bc-platform-auth.withhive.com/v2/refresh-token
ลิงก์ Sandbox 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 ใหม่เมื่อ 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"
  }
}