ดึงข้อมูล Chain

GEThttps://api.omise.co/chains/{id}

ดึงรายละเอียดการเชื่อมต่อ chain merchant เฉพาะ Chains แทน sub-merchants ที่ได้อนุญาตให้บัญชีอื่นสร้างการเรียกเก็บเงินและดำเนินการในนามของพวกเขา

---

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

▼

---

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

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

▼

`id`STRING(required)

ตัวระบุ Chain ตรงกับรูปแบบ /acch(_test)?_[0-9a-z]+/ ระบุใน URL path

Example:"acch_test_5xuy4w91xqz7d1w9u0t"

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

---

การตอบกลับ

200

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

ดึง chain สำเร็จ ส่งคืน chain object พร้อมรายละเอียดการเชื่อมต่อ

การตอบกลับประกอบด้วย:

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

400

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

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

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

• รูปแบบ chain ID ไม่ถูกต้อง
• คำขอผิดรูปแบบ

401

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

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

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

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

404

ไม่พบ

ไม่พบ chain ด้วย ID ที่ระบุ

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

• รูปแบบ chain ID ไม่ถูกต้อง
• ไม่มี chain อยู่
• Chain เป็นของบัญชีอื่น
• ใช้ test key กับ live chain ID (หรือกลับกัน)

5xx

ข้อผิดพลาดเซิร์ฟเวอร์

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

วิธีจัดการ:

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

---

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

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 key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
not_found	ไม่พบ chain	ตรวจสอบว่า chain ID ถูกต้องและมีอยู่
invalid_chain_id	Chain ID ผิดรูปแบบ	ตรวจสอบให้ ID ตรงกับรูปแบบ acch(test)?[0-9a-z]+

ฟิลด์ Chain Object

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

---

ลองใช้งาน

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