API DOKUMENTÁCIÓ

Banki kivonatok konvertálása programozottan

// ELSŐ LÉPÉSEK

A BSC API lehetővé teszi PDF banki kivonatok Excel (.xlsx) vagy CSV formátumba való programozott konvertálását. Minden API konvertálás beleszámít a csomagod havi oldal limitjébe, és megjelenik a "Legutóbbi" konvertálások listájában.

1. Fizess elő bármelyik fizetős csomagra

2. Generálj egy API tokent az API Hozzáférés részben a főoldalon

3. Küldj kéréseket a tokeneddel a Authorization fejlécben

// HITELESÍTÉS

Minden API kéréshez Bearer token szükséges. Helyezd el a Authorization fejlécben:

Authorization: Bearer bsc_your_token_here

A tokenek csak generáláskor jelennek meg egyszer. Ha elveszíted a tokent, vond vissza és hozz létre újat.

// KONVERTÁLÁS VÉGPONT

POST/api/v1/convert

Kérés

Rész	Részletek
Content-Type	`multipart/form-data`
Body mező	`file` — a PDF fájl
Authorization	`Bearer <token>`

Lekérdezési paraméterek

Paraméter	Típus	Alapértelmezett	Leírás
`format`	string	`xlsx`	Kimeneti formátum: `xlsx` vagy `csv`
`minimal`	string	`false`	Állítsd `true` értékre az összes fejléc eltávolításához — csak nyers tranzakciós sorok

Válasz

200 OK — A konvertált fájl bináris letöltésként (xlsx vagy csv)

Egyedi válasz fejlécek metaadatokkal:

Fejléc	Leírás
`X-BSC-Bank`	Felismert bank neve
`X-BSC-Transactions`	Kinyert tranzakciók száma
`X-BSC-Partial`	true, ha csak részleges oldalak lettek feldolgozva (csomag limit)
`X-BSC-Pages-Processed`	Ténylegesen feldolgozott oldalak száma
`X-BSC-Pages-Total`	Összes oldal a PDF-ben

Hibaválaszok

A hibák JSON formátumban térnek vissza egy error mezővel:

Státusz	Jelentés
`400`	Hibás kérés (hiányzó fájl, érvénytelen formátum, nem PDF)
`401`	Érvénytelen vagy hiányzó API token
`403`	Nincs aktív előfizetés
`429`	Oldal limit elérve
`500`	Konvertálás sikertelen (feldolgozási hiba)

// KIMENETI FORMÁTUMOK

XLSX (alapértelmezett)

> Normál: banki információ fejléc, oszlopnevek, formázott sorok

> Minimális: csak nyers tranzakciós sorok, fejlécek és formázás nélkül

CSV

> Normál: banki info, oszlop fejlécek, majd tranzakciós sorok

> Minimális: csak tranzakciós sorok — dátum,leírás,összeg,egyenleg,hivatkozás,partner

// PÉLDÁK

Konvertálás Excelbe:

curl -X POST "/api/v1/convert?format=xlsx" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@statement.pdf" \
  --output converted.xlsx

Konvertálás CSV-be:

curl -X POST "/api/v1/convert?format=csv" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@statement.pdf" \
  --output converted.csv

Minimális CSV (csak adatok, fejlécek nélkül):

curl -X POST "/api/v1/convert?format=csv&minimal=true" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@statement.pdf" \
  --output data.csv

// FELHASZNÁLÁS ÉS LIMITEK

Az API konvertálások a csomagod havi oldal limitjéből vonódnak le. A feltöltött PDF minden oldala egy oldalnak számít a limit felé.

Starter500 oldal/hónap

Pro2 000 oldal/hónap

Business6 000 oldal/hónap

Ha túlléped a limitet, az API 429 státuszt ad vissza. Ha egy PDF-nek több oldala van, mint a maradék kvótád, csak az engedélyezett oldalak kerülnek feldolgozásra és a részleges jelző beállításra kerül.

// ADATOSZLOPOK

Minden tranzakciós sor az alábbi mezőket tartalmazza (xlsx és csv esetén egyaránt):

Oszlop	Típus	Leírás
date	string	Tranzakció dátuma (ÉÉÉÉ-HH-NN)
description	string	Tranzakció leírása / megjegyzés
amount	number	Pozitív = jóváírás, negatív = terhelés
balance	number?	Tranzakció utáni egyenleg (lehet üres)
reference	string?	Banki hivatkozás vagy tranzakció azonosító
counterparty	string?	Másik fél neve

// SEGÍTSÉGRE VAN SZÜKSÉGED?

Problémád van az API-val? Lépj velünk kapcsolatba: vagy használd a kapcsolati űrlapot a főoldalon.

Vissza az alkalmazáshoz|ÁSZF|Adatvédelem