Senet Listeleme

Firmaya ait senetleri listeleme.

Endpoint

GET /kolaybi/v1/bonds

Parametreler

Parametre	Tip	Zorunlu	Açıklama
bond_status	BondStatus	Hayır	Senet durumu ile filtreleme
cash_flow_direction	CashFlowDirection	Hayır	Nakit yönü (1 alınan senet, -1 verilen senet)
bond_id	integer	Hayır	Senet ID'si ile filtreleme
serial_no	string	Hayır	Seri numarası içerenler
drawer	string	Hayır	Borçlu adı içerenler
payee	string	Hayır	Alacaklı adı içerenler
guarantor	string	Hayır	Kefil adı içerenler
associate_id	integer	Hayır	Senetleri görüntülenecek cari ID'si
currency	Currency	Hayır	Para birimi
min_amount	number	Hayır	Minimum tutar
max_amount	number	Hayır	Maksimum tutar
min_issue_date	string	Hayır	Minimum düzenleme tarihi (YYYY-MM-DD)
max_issue_date	string	Hayır	Maksimum düzenleme tarihi (YYYY-MM-DD)
receive_start_date	string	Hayır	Minimum vade tarihi (YYYY-MM-DD)
receive_end_date	string	Hayır	Maksimum vade tarihi (YYYY-MM-DD)

Örnekler

cURL

# Tüm senetler
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/bonds" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

# Portföydeki alınan senetler
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/bonds?bond_status=portfolio&cash_flow_direction=1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

# Vade aralığı ile filtreleme
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/bonds?receive_start_date=2026-01-01&receive_end_date=2026-06-30" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

JavaScript

async function getBonds(filters = {}) {
  const params = new URLSearchParams(filters);
  const response = await fetch(
    `https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/bonds?${params}`,
    {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel,
      },
    }
  );
  return await response.json();
}

// Kullanım
const allBonds = await getBonds();
const portfolioBonds = await getBonds({
  bond_status: "portfolio",
  cash_flow_direction: 1,
});

PHP

function getBonds($filters = []) {
    $url = 'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/bonds';
    if (!empty($filters)) {
        $url .= '?' . http_build_query($filters);
    }

    $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
$allBonds = getBonds();
$portfolioBonds = getBonds([
    'bond_status' => 'portfolio',
    'cash_flow_direction' => 1,
]);

Python

import requests

def get_bonds(filters=None):
    url = "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/bonds"
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Channel": channel
    }

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

# Kullanım
all_bonds = get_bonds()
portfolio_bonds = get_bonds({
    "bond_status": "portfolio",
    "cash_flow_direction": 1
})

C#

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

async Task<dynamic> GetBondsAsync(Dictionary<string, string> filters = null)
{
    using var client = new HttpClient();

    var url = "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/bonds";
    if (filters != null && filters.Count > 0)
    {
        var query = await new FormUrlEncodedContent(filters).ReadAsStringAsync();
        url += "?" + query;
    }

    var request = new HttpRequestMessage(HttpMethod.Get, url);
    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 allBonds = await GetBondsAsync();
var portfolioBonds = await GetBondsAsync(new Dictionary<string, string>
{
    { "bond_status", "portfolio" },
    { "cash_flow_direction", "1" }
});

Yanıt

Başarılı Yanıt

{
  "data": [
    {
      "id": 84,
      "detail_id": 11,
      "serial_no": "SNT-2026-001",
      "receive_date": "2026-04-30 00:00:00",
      "issue_date": "2026-01-30 00:00:00",
      "bond_status": "portfolio",
      "cash_flow_direction": 1,
      "amount": 25000.0,
      "currency": "try",
      "description": "1. taksit",
      "drawer": "Örnek Borçlu A.Ş.",
      "payee": "Örnek Alacaklı Ltd. Şti.",
      "guarantor": "Örnek Kefil",
      "guarantor_identity_no": "12345678901",
      "issue_place": "Ankara",
      "authorized_court_province": "Ankara",
      "associate_id": 7,
      "vault_id": 3,
      "endorsed_associate_id": null,
      "tags": [
        {
          "id": 12,
          "name": "Tahsilat",
          "description": null
        }
      ]
    }
  ]
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Senet kayıtları (data[n])

Kayıt Alanları (data[n])

Alan	Tip	Açıklama
id	integer	Senet (taksit) ID
detail_id	integer	Taksitleri birbirine bağlayan senet ID'si
serial_no	string	Seri numarası
receive_date	string	Vade tarihi
issue_date	string	Düzenleme tarihi
bond_status	BondStatus	Senet durumu
cash_flow_direction	CashFlowDirection	Nakit yönü
amount	number	Taksit tutarı
currency	Currency	Para birimi
description	string	Açıklama
drawer	string	Borçlu
payee	string	Alacaklı
guarantor	string	Kefil
guarantor_identity_no	string	Kefil TC kimlik numarası
issue_place	string	Düzenleme yeri
authorized_court_province	string	Yetkili mahkeme ili
associate_id	integer	İlişkili cari ID
vault_id	integer	Banka/kasa ID
endorsed_associate_id	integer	Ciro edilen cari ID
tags	array	Etiketler (id, name, description)