アカウントを取得

GEThttps://api.omise.co/account

アカウントに関する情報を返します。テストAPIキーと本番APIキーの両方で同じアカウント詳細が返されます。このエンドポイントを使用して、アカウントの構成と機能を確認します。

---

🔑API認証情報

▼

---

リクエストパラメータ

このエンドポイントにはパラメータは必要ありません。

---

レスポンス

200

リクエスト成功

すべての構成詳細を含むアカウントオブジェクトを返します。

アカウントオブジェクトには以下が含まれます:

• id - アカウント識別子
• email - アカウントのメールアドレス
• country - ISO 3166の2文字の国コード
• currency - ISO 4217の3文字の通貨コード
• supported_currencies - 課金でサポートされている通貨の配列
• webhook_uri - アカウントイベント通知用のURI
• api_version - アカウントのデフォルトAPIバージョン
• chain_enabled - マーケットプレイス機能が有効かどうかを示すブール値
• chain_return_uri - マーケットプレイス取引のリターンURI
• zero_interest_installments - マーチャント負担の分割払いのブール値
• metadata_export_keys - エクスポートに含まれるメタデータキー
• created_at - アカウント作成タイムスタンプ（ISO 8601）

401

認証失敗

認証に失敗しました。無効または欠落したAPIキー。

一般的な原因:

• Authorizationヘッダーがない
• 無効な秘密キー
• 秘密キーの代わりに公開キーを使用
• 不正なHTTP Basic Auth形式

5xx

サーバーエラー

サーバーサイドエラーが発生しました。これらはまれですが、適切に処理する必要があります。

対処方法:

• 指数バックオフでリクエストを再試行
• status.omise.coでサービスインシデントを確認
• 詳細なガイダンスはエラー処理を参照

---

コードサンプル

cURL

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

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

account = Omise::Account.retrieve

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

account = omise.Account.retrieve()

Node.js

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

const account = await omise.account.retrieve();

PHP

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

$account = OmiseAccount::retrieve();

Java

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

Account account = client.account().get();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var account = await client.Account.Get();

Go

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

account, _ := client.Account().Get()

---

試してみる

あなたのIP: ...読み込み中...