ดึงข้อมูล Chain Transfer

GEThttps://api.omise.co/chains/:chain_id

ดึงข้อมูล chain เฉพาะด้วยตัวระบุของมัน ส่งคืนออบเจ็กต์ chain ที่รวมถึงรายละเอียดการเรียกเก็บเงินและการโอนที่เกี่ยวข้อง

---

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

▼

---

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

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

▼

`chain_id`STRING(required)

ตัวระบุ chain ที่ตรงกับรูปแบบ /acch(_test)?_[0-9a-z]+/ ระบุไว้ในเส้นทาง URL

Example:"acch_test_5xuy4w91xqz7d1w9u0t"

Constraints:ต้องเป็น chain ID ที่ถูกต้อง

---

การตอบกลับ

200

ดึงข้อมูลสำเร็จ

ดึงข้อมูล chain สำเร็จ ส่งคืนออบเจ็กต์ chain ที่สมบูรณ์พร้อมรายละเอียดการเรียกเก็บเงินและการโอน

การตอบกลับรวมถึง:

• id - ตัวระบุ chain
• key - คีย์การยืนยันตัวตนสำหรับ sub-merchant
• email - อีเมลบัญชี sub-merchant
• revoked - ระบุว่าการเข้าถึง chain ถูกเพิกถอนหรือไม่
• created_at - ตราประทับเวลาการสร้าง

401

ไม่ได้รับการยืนยันตัวตน

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

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

• ขาดส่วนหัว Authorization
• คีย์ลับไม่ถูกต้อง
• ใช้คีย์สาธารณะแทนคีย์ลับ
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

ไม่พบ chain ที่มี ID ที่ระบุ

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

• รูปแบบ chain ID ไม่ถูกต้อง
• chain ไม่มีอยู่
• chain เป็นของบัญชีอื่น
• ใช้คีย์ทดสอบกับ chain ID สภาพแวดล้อมจริง (หรือในทางกลับกัน)

---

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

cURL

curl https://api.omise.co/chains/acch_test_5xuy4w91xqz7d1w9u0t \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

chain = Omise::Chain.retrieve('acch_test_5xuy4w91xqz7d1w9u0t')

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

chain = omise.Chain.retrieve('acch_test_5xuy4w91xqz7d1w9u0t')

Node.js

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

const chain = await omise.chains.retrieve('acch_test_5xuy4w91xqz7d1w9u0t');

PHP

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

$chain = OmiseChain::retrieve('acch_test_5xuy4w91xqz7d1w9u0t');

Java

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

Chain chain = client.chains().get("acch_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var chain = await client.Chains.Get("acch_test_5xuy4w91xqz7d1w9u0t");

Go

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

chain, _ := client.Chains().Get("acch_test_5xuy4w91xqz7d1w9u0t")

---

รหัสข้อผิดพลาดและผลลัพธ์

รหัสข้อผิดพลาดทั่วไป

รหัส	คำอธิบาย	วิธีแก้ไข
authentication_failure	คีย์ API ไม่ถูกต้อง	ตรวจสอบว่าคีย์ลับของคุณถูกต้อง
not_found	ไม่พบ chain	ตรวจสอบว่า chain ID ถูกต้องและมีอยู่จริง
invalid_chain_id	chain ID ไม่ถูกต้อง	ตรวจสอบว่า ID ตรงกับรูปแบบ acch(test)?[0-9a-z]+

ฟิลด์ของออบเจ็กต์ Chain

ฟิลด์	ประเภท	คำอธิบาย
object	string	ส่งคืน "chain" เสมอ
id	string	ตัวระบุ chain ที่ไม่ซ้ำ
key	string	คีย์การยืนยันตัวตนสำหรับดำเนินการในนาม sub-merchant
email	string	อีเมลบัญชี sub-merchant
livemode	boolean	ตัวบ่งชี้สภาพแวดล้อมจริงและทดสอบ
revoked	boolean	ระบุว่าการเข้าถึง chain ถูกเพิกถอนหรือไม่
created_at	string	ตราประทับเวลาการสร้าง (ISO 8601)

---

ลองใช้งาน

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

▼

chain_id(จำเป็น)