Hızlı Başlangıç

1. API Anahtarı Alın

Hesap yöneticinizden API anahtarınızı talep edin. Anahtar bil_ önekiyle başlar:

bil_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

2. Tüm Endpoint'lere Örnekler

cURL

bash

API_KEY="bil_your_api_key_here"
BASE="https://api.bilvio.com"

# Bakiye sorgula (ücretsiz)
curl "$BASE/v1/search/balance" \
  -H "Authorization: Bearer $API_KEY"

# VKN ile genel bilgi
curl -X POST "$BASE/v1/search/vkn" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vkn": "9000500394"}'

# VKN ile detaylı bilgi — ortaklar, temsilciler, şubeler
curl -X POST "$BASE/v1/search/vkn/detail" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vkn": "9000500394"}'

# Ünvan ile genel bilgi
curl -X POST "$BASE/v1/search/title" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "UYUMSOFT"}'

# Ünvan ile detaylı bilgi
curl -X POST "$BASE/v1/search/title/detail" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "UYUMSOFT"}'

# Mersis No ile şube kartı
curl -X POST "$BASE/v1/search/mersis" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mersis_no": "0900050039400002"}'

JavaScript (fetch)

javascript

const API_KEY = 'bil_your_api_key_here'
const BASE    = 'https://api.bilvio.com'

async function bilvio(endpoint, body = null) {
  const res = await fetch(`${BASE}${endpoint}`, {
    method: body ? 'POST' : 'GET',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: body ? JSON.stringify(body) : undefined,
  })
  if (!res.ok) {
    const err = await res.json()
    throw new Error(err.error || 'İstek başarısız')
  }
  return res.json()
}

// Bakiye
const { balance } = await bilvio('/v1/search/balance')
console.log('Bakiye:', balance)

// VKN ile genel bilgi
const r1 = await bilvio('/v1/search/vkn', { vkn: '9000500394' })
console.log(r1.data.Merkez.Unvani)   // "UYUMSOFT KURUMSAL İŞ SİSTEMLERİ..."
console.log(r1.data.Merkez.Durumu)   // "Aktif"
console.log(r1.data.Merkez.Adres)
console.log(r1.dusulen_bakiye)         // 1

// VKN ile detaylı bilgi
const r2 = await bilvio('/v1/search/vkn/detail', { vkn: '9000500394' })
console.log(r2.data.Merkez.Unvani)
console.log(r2.data.Ortaklar)        // ortak listesi
console.log(r2.data.AktifTemsilciler)
console.log(r2.data.Subeler)         // şube listesi
console.log(r2.dusulen_bakiye)         // 3

// Ünvan ile genel bilgi
const r3 = await bilvio('/v1/search/title', { title: 'UYUMSOFT' })
console.log(r3.matched.ad)           // "Uyumsoft Bilgi Sistemleri..."
console.log(r3.matched.vkn)          // "9000068418"
console.log(r3.matched.score)        // 1.0
console.log(r3.data.Merkez.Unvani)
console.log(r3.alternatives)         // diğer eşleşmeler
console.log(r3.dusulen_bakiye)         // 2

// Ünvan ile detaylı bilgi
const r4 = await bilvio('/v1/search/title/detail', { title: 'UYUMSOFT' })
console.log(r4.matched.ad)
console.log(r4.data.Merkez.Unvani)
console.log(r4.data.Ortaklar)
console.log(r4.dusulen_bakiye)         // 4

// Mersis No ile şube kartı
const r5 = await bilvio('/v1/search/mersis', { mersis_no: '0900050039400002' })
console.log(r5.data.Sube.Unvani)     // şube ünvanı
console.log(r5.data.Sube.Durumu)
console.log(r5.data.Sube.SubeMerkeziMersisNo)
console.log(r5.dusulen_bakiye)         // 2

Python

python

import requests

API_KEY = 'bil_your_api_key_here'
BASE    = 'https://api.bilvio.com'
HEADERS = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json',
}

def bilvio(endpoint, body=None):
    if body:
        r = requests.post(f'{BASE}{endpoint}', json=body, headers=HEADERS)
    else:
        r = requests.get(f'{BASE}{endpoint}', headers=HEADERS)
    r.raise_for_status()
    return r.json()

# Bakiye
data = bilvio('/v1/search/balance')
print('Bakiye:', data['balance'])

# VKN ile genel bilgi
r1 = bilvio('/v1/search/vkn', {'vkn': '9000500394'})
merkez = r1['data']['Merkez']
print(merkez['Unvani'])    # "UYUMSOFT KURUMSAL İŞ SİSTEMLERİ..."
print(merkez['Durumu'])    # "Aktif"
print(merkez['Adres'])
print(r1['dusulen_bakiye'])  # 1

# VKN ile detaylı bilgi
r2 = bilvio('/v1/search/vkn/detail', {'vkn': '9000500394'})
print(r2['data']['Merkez']['Unvani'])
print(r2['data']['Ortaklar'])
print(r2['data']['AktifTemsilciler'])
print(r2['data']['Subeler'])
print(r2['dusulen_bakiye'])  # 3

# Ünvan ile genel bilgi
r3 = bilvio('/v1/search/title', {'title': 'UYUMSOFT'})
print(r3['matched']['ad'])           # "Uyumsoft Bilgi Sistemleri..."
print(r3['matched']['vkn'])          # "9000068418"
print(r3['matched']['score'])        # 1.0
print(r3['data']['Merkez']['Unvani'])
print(r3['dusulen_bakiye'])            # 2

# Ünvan ile detaylı bilgi
r4 = bilvio('/v1/search/title/detail', {'title': 'UYUMSOFT'})
print(r4['matched']['ad'])
print(r4['data']['Ortaklar'])
print(r4['dusulen_bakiye'])            # 4

# Mersis No ile şube kartı
r5 = bilvio('/v1/search/mersis', {'mersis_no': '0900050039400002'})
print(r5['data']['Sube']['Unvani'])
print(r5['data']['Sube']['Durumu'])
print(r5['dusulen_bakiye'])            # 2

PHP

php

<?php
define('API_KEY', 'bil_your_api_key_here');
define('BASE',    'https://api.bilvio.com');

function bilvio($endpoint, $body = null) {
    $ch = curl_init(BASE . $endpoint);
    $opts = [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => [
            'Authorization: Bearer ' . API_KEY,
            'Content-Type: application/json',
        ],
    ];
    if ($body !== null) {
        $opts[CURLOPT_POST]       = true;
        $opts[CURLOPT_POSTFIELDS] = json_encode($body);
    }
    curl_setopt_array($ch, $opts);
    $response = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $response;
}

// Bakiye
$r = bilvio('/v1/search/balance');
echo 'Bakiye: ' . $r['balance'] . PHP_EOL;

// VKN ile genel bilgi
$r1 = bilvio('/v1/search/vkn', ['vkn' => '9000500394']);
echo $r1['data']['Merkez']['Unvani'] . PHP_EOL;  // "UYUMSOFT KURUMSAL..."
echo $r1['data']['Merkez']['Durumu'] . PHP_EOL;  // "Aktif"
echo $r1['dusulen_bakiye'] . PHP_EOL;              // 1

// VKN ile detaylı bilgi
$r2 = bilvio('/v1/search/vkn/detail', ['vkn' => '9000500394']);
echo $r2['data']['Merkez']['Unvani'] . PHP_EOL;
print_r($r2['data']['Ortaklar']);
print_r($r2['data']['Subeler']);
echo $r2['dusulen_bakiye'] . PHP_EOL;  // 3

// Ünvan ile genel bilgi
$r3 = bilvio('/v1/search/title', ['title' => 'UYUMSOFT']);
echo $r3['matched']['ad'] . PHP_EOL;              // "Uyumsoft Bilgi Sistemleri..."
echo $r3['matched']['vkn'] . PHP_EOL;             // "9000068418"
echo $r3['data']['Merkez']['Unvani'] . PHP_EOL;
echo $r3['dusulen_bakiye'] . PHP_EOL;               // 2

// Ünvan ile detaylı bilgi
$r4 = bilvio('/v1/search/title/detail', ['title' => 'UYUMSOFT']);
echo $r4['matched']['ad'] . PHP_EOL;
print_r($r4['data']['Ortaklar']);
echo $r4['dusulen_bakiye'] . PHP_EOL;  // 4

// Mersis No ile şube kartı
$r5 = bilvio('/v1/search/mersis', ['mersis_no' => '0900050039400002']);
echo $r5['data']['Sube']['Unvani'] . PHP_EOL;
echo $r5['data']['Sube']['Durumu'] . PHP_EOL;
echo $r5['dusulen_bakiye'] . PHP_EOL;  // 2

3. Yanıt Yapısı Özeti

Endpoint	Veri nerede?
`/vkn` ve `/title`	`data.Merkez.Unvani`, `data.Merkez.Durumu`...
`/vkn/detail` ve `/title/detail`	`data.Merkez` + `data.Ortaklar`, `data.AktifTemsilciler`, `data.Subeler`...
`/mersis`	`data.Sube.Unvani`, `data.Sube.Durumu`...
Ünvan aramasında ek	`matched.ad`, `matched.vkn`, `matched.score`, `alternatives`

Hızlı Başlangıç ​

1. API Anahtarı Alın ​

2. Tüm Endpoint'lere Örnekler ​

cURL ​

JavaScript (fetch) ​

Python ​

PHP ​

3. Yanıt Yapısı Özeti ​

Hızlı Başlangıç

1. API Anahtarı Alın

2. Tüm Endpoint'lere Örnekler

cURL

JavaScript (fetch)

Python

PHP

3. Yanıt Yapısı Özeti