สร้างการยืนยัน MFA

POSThttps://api.omise.co/mfa_confirmations

สร้างการยืนยันการตรวจสอบสิทธิ์หลายปัจจัยสำหรับการดำเนินการบัญชีที่ปลอดภัย การยืนยัน MFA ให้ชั้นความปลอดภัยเพิ่มเติมสำหรับการดำเนินการที่มีความละเอียดอ่อน

---

พารามิเตอร์คำขอ

จำเป็น - 1 ฟิลด์พารามิเตอร์ที่จำเป็น

▼

`code`STRING(required)

รหัสยืนยัน MFA จากแอปตรวจสอบสิทธิ์หรือ SMS

Example:"123456"

เพิ่มเติม - 1 ฟิลด์พารามิเตอร์เพิ่มเติม

▼

---

การตอบกลับ

200

สร้างการยืนยัน MFA สำเร็จ

สร้างและตรวจสอบการยืนยัน MFA แล้ว ขณะนี้สามารถใช้การยืนยันสำหรับการดำเนินการที่เกี่ยวข้องได้

ฟิลด์ออบเจกต์การยืนยัน MFA:

• object - ค่าสตริง "mfa_confirmation"
• id - ID การยืนยัน MFA (mfa_*) ใช้สำหรับการดำเนินการต่อไป
• location - เส้นทาง API endpoint สำหรับการยืนยันนี้
• verified - ค่าบูลีนระบุว่ารหัส MFA ถูกต้องหรือไม่
• action - การดำเนินการที่การยืนยันนี้ใช้สำหรับ
• expires_at - timestamp หมดอายุของการยืนยัน (ISO 8601)
• created_at - timestamp การสร้างการยืนยัน (ISO 8601)

400

คำขอไม่ถูกต้อง

การตรวจสอบคำขอล้มเหลว ตรวจสอบข้อความ error สำหรับรายละเอียด

สาเหตุทั่วไป:

• ขาดพารามิเตอร์ code ที่จำเป็น
• รูปแบบรหัสไม่ถูกต้อง
• รหัส MFA ไม่ถูกต้อง
• รหัส MFA หมดอายุ

401

ไม่ได้รับอนุญาต

การยืนยันตัวตนล้มเหลว API key ไม่ถูกต้องหรือขาดหายไป

สาเหตุทั่วไป:

• ขาด Authorization header
• Secret key ไม่ถูกต้อง
• ใช้ public key แทน secret key
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

ไม่พบการตั้งค่า MFA สำหรับบัญชี

สาเหตุทั่วไป:

• ยังไม่ได้เปิดใช้งาน MFA สำหรับบัญชี
• บัญชีไม่มีการตั้งค่า MFA

5xx

เซิร์ฟเวอร์ error

เกิด error ฝั่งเซิร์ฟเวอร์ กรณีนี้พบได้น้อยแต่ควรจัดการอย่างเหมาะสม

วิธีจัดการ:

• ลองส่งคำขอใหม่ด้วย exponential backoff
• ตรวจสอบ status.omise.co สำหรับเหตุการณ์บริการ
• ดู การจัดการ Error สำหรับคำแนะนำโดยละเอียด

---

ตัวอย่างโค้ด

cURL

curl https://api.omise.co/mfa_confirmations \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "code=123456" \
  -d "action=transfer_creation"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

mfa_confirmation = Omise::MfaConfirmation.create({
  code: '123456',
  action: 'transfer_creation'
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

mfa_confirmation = omise.MfaConfirmation.create(
    code='123456',
    action='transfer_creation'
)

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const mfaConfirmation = await omise.mfaConfirmations.create({
  code: '123456',
  action: 'transfer_creation'
});

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$mfaConfirmation = OmiseMfaConfirmation::create([
    'code' => '123456',
    'action' => 'transfer_creation'
]);

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

MfaConfirmation mfaConfirmation = client.mfaConfirmations().create()
    .code("123456")
    .action("transfer_creation")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var mfaConfirmation = await client.MfaConfirmations.Create(new CreateMfaConfirmationRequest
{
    Code = "123456",
    Action = "transfer_creation"
});

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "skey_test_5xuy4w91xqz7d1w9u0t",
)

mfaConfirmation, _ := client.MfaConfirmations().Create(&operations.CreateMfaConfirmation{
    Code:   "123456",
    Action: "transfer_creation",
})

---

รหัส Error และผลลัพธ์

รหัส Error ทั่วไป

รหัส	คำอธิบาย	วิธีแก้ไข
bad_request	พารามิเตอร์ขาดหายหรือไม่ถูกต้อง	ตรวจสอบรูปแบบรหัสและฟิลด์ที่จำเป็น
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
invalid_mfa_code	รหัส MFA ไม่ถูกต้อง	ป้อนรหัสที่ถูกต้องจากแอปตรวจสอบสิทธิ์
expired_mfa_code	รหัส MFA หมดอายุ	ขอรหัสใหม่และลองอีกครั้ง
mfa_not_enabled	ไม่ได้ตั้งค่า MFA	เปิดใช้งาน MFA ในบัญชีก่อน

ฟิลด์การยืนยัน MFA

ฟิลด์	คำอธิบาย
id	ID การยืนยัน MFA (ใช้สำหรับการดำเนินการต่อไป)
verified	ค่าบูลีนระบุว่า MFA สำเร็จหรือไม่
action	การดำเนินการที่การยืนยันนี้อนุญาต
expires_at	เวลาที่การยืนยันหมดอายุ
created_at	timestamp การสร้างการยืนยัน

---

🔑ข้อมูลยืนยันตัวตน API

▼

ลองใช้งาน

จำเป็น - 1 ฟิลด์

▼

code(จำเป็น)

เพิ่มเติม - 1 ฟิลด์

▼

IP ของคุณ: ...กำลังโหลด...