Online Banka Hesap Listeleme

Online banka hesaplarını listeler.

Endpoint

GET /kolaybi/v1/online_bank/accounts

Parametreler

Bu endpoint herhangi bir parametre almaz.

Örnekler

cURL

curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

JavaScript

async function getOnlineBankAccounts() {
  const response = await fetch(
    "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts",
    {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel
      }
    }
  );
  return await response.json();
}

// Kullanım
const accounts = await getOnlineBankAccounts();

PHP

function getOnlineBankAccounts() {
    $url = 'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts';

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $accessToken,
            'Channel: ' . $channel
        ],
        CURLOPT_RETURNTRANSFER => true
    ]);

    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

// Kullanım
$accounts = getOnlineBankAccounts();

Python

import requests

def get_online_bank_accounts():
    url = "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts"
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Channel": channel
    }

    response = requests.get(url, headers=headers)
    return response.json()

# Kullanım
accounts = get_online_bank_accounts()

C#

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using Newtonsoft.Json;

async Task<dynamic> GetOnlineBankAccountsAsync()
{
    using var client = new HttpClient();

    var request = new HttpRequestMessage(HttpMethod.Get,
        "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts");

    request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
    request.Headers.Add("Channel", channel);

    var response = await client.SendAsync(request);
    var content = await response.Content.ReadAsStringAsync();
    return JsonConvert.DeserializeObject<dynamic>(content);
}

// Kullanım
var accounts = await GetOnlineBankAccountsAsync();

Yanıt

Başarılı Yanıt

{
  "data": [
    {
      "id": "64f1c2e9a1b2c3d4e5f60718",
      "bank_id": "64e7b3d1c0a9f8e7d6c50421",
      "bank_code": "0064",
      "bank_name": "İş Bankası",
      "branch_name": "Merkez Şube",
      "account_alias": "İşletme Hesabı",
      "account_type": "vadesiz",
      "iban": "TR330006100519786457841326",
      "currency": "TRY",
      "balance": 125430.75
    }
  ],
  "message": "Online banka hesapları başarıyla listelendi.",
  "success": true
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Hesap kayıtları (data[n])
message	string	Yanıt mesaj kodu
success	boolean	İşlem başarı durumu

Kayıt Alanları (data[n])

Alan	Tip	Açıklama
id	string	Sağlayıcı hesap kimliği
bank_id	string	Sağlayıcı banka kimliği; banka endpoint'lerinde bank_id olarak kullanılır
bank_code	string	Banka kodu
bank_name	string	Banka adı
branch_name	string | null	Şube adı
account_alias	string	Hesap takma adı
account_type	string	Hesap türü
iban	string	IBAN
currency	string	Para birimi (örn. TRY)
balance	number	Hesap bakiyesi