Banka/Kasa Hareketleri

Belirtilen banka/kasa hesabının işlem geçmişini listeler.

Endpoint

GET /kolaybi/v1/vaults/{vault_id}/transactions

Parametreler

Parametre	Tip	Zorunlu	Açıklama
vault_id	integer	Evet	İşlem geçmişi görüntülenecek hesap ID'si

Örnekler

cURL

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

JavaScript

async function getVaultTransactions(vaultId) {
  const response = await fetch(
    `https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/vaults/${vaultId}/transactions`,
    {
      method: "GET",
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel,
      },
    }
  );

  return await response.json();
}

// Kullanım
const transactions = await getVaultTransactions(1);

PHP

function getVaultTransactions($vaultId) {
    $url = "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/vaults/{$vaultId}/transactions";

    $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
$transactions = getVaultTransactions(1);

Python

import requests

def get_vault_transactions(vault_id):
    url = f"https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/vaults/{vault_id}/transactions"
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Channel": channel
    }

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

# Kullanım
transactions = get_vault_transactions(1)

C#

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

async Task<dynamic> GetVaultTransactionsAsync(int vaultId)
{
    using var client = new HttpClient();

    var request = new HttpRequestMessage(HttpMethod.Get,
        $"https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/vaults/{vaultId}/transactions");

    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 transactions = await GetVaultTransactionsAsync(1);

Yanıt

Başarılı Yanıt

{
  "data": [
    {
      "id": 1,
      "type": "income",
      "amount": 1000.0,
      "currency": "TRY",
      "description": "Müşteri ödemesi",
      "date": "2024-01-15T10:30:00Z",
      "balance": 1000.0,
      "reference": "INV-001",
      "category": "payment"
    },
    {
      "id": 2,
      "type": "expense",
      "amount": -500.0,
      "currency": "TRY",
      "description": "Tedarikçi ödemesi",
      "date": "2024-01-16T14:20:00Z",
      "balance": 500.0,
      "reference": "PO-001",
      "category": "payment"
    }
  ]
}

Yanıt Alanları

Alan	Tip	Açıklama
id	integer	İşlem ID
type	string	İşlem türü
amount	number	İşlem tutarı
currency	string	Para birimi
description	string	İşlem açıklaması
date	string	İşlem tarihi (ISO 8601)
balance	number	Güncel bakiye
reference	string	Referans numarası
category	string	İşlem kategorisi

Kurallar

Önemli

• Hesap ID: Geçerli bir banka/kasa hesap ID'si olmalı
• Tarih Sırası: İşlemler tarih sırasına göre listelenir
• Bakiye: Her işlem için güncel bakiye hesaplanır
• Maksimum: 1000 işlem döndürülür