Dokumentacija

Išsami Lietuvos įmonių duomenų API dokumentacija su pavyzdžiais ir rizikos vertinimu

Dokumentacija

Išsamus vadovas naudojantis Credora.lt platforma - Lietuvos įmonių duomenų API. Gaukite prieigą prie oficialių registrų duomenų ir pažangaus rizikos vertinimo per paprastą REST API.

Greitas startas

Pradėkite naudoti Credora API per kelias minutes. Šis vadovas padės jums atlikti pirmas užklausas ir gauti duomenis.

1. Gaukite API raktą

Užsiregistruokite platformoje ir sukurkite savo API raktą valdymo skydelyje. API raktas reikalingas visoms užklausoms autentifikuoti.

Eiti į valdymo skydą

2. Atlikite pirmą užklausą

Išbandykite API su paprasta įmonių paieškos užklausa. Naudokite savo API raktą autentifikavimui.

Pirma API užklausa
curl -H "Authorization: Bearer jūsų_api_raktas" \
  "https://credora.lt/api/companies/search?q=UAB"

3. Integruokite į projektą

Naudokite bet kurią HTTP biblioteką jūsų programavimo kalboje. Žemiau pateikti pavyzdžiai populiariausioms kalboms. Jei kyla sunkumų, visada galite naudoti paieškos widgetą, kuris integruojasi dar paprasčiau.

API Dokumentacija

Išsami API dokumentacija su visais metodais, parametrais ir interaktyviais pavyzdžiais.

Autentifikavimas

Visi API metodai reikalauja autentifikavimo naudojant API raktą. Šis raktas turi būti įtrauktas į kiekvieną užklausą.

Saugumas

Niekada neatskleiskite savo API rakto viešai. Saugokite jį kaip slaptažodį. Jei kilo abejonių, jog raktas buvo atskleitas kitiems asmenims, būtinai valdymo zonoje pergeneruokite raktą.

Autentifikavimo pavyzdys
curl -H "Authorization: Bearer ak_live_jūsų_api_raktas" \
                "https://credora.lt/api/companies/search?q=UAB"
GET/companies/search

Įmonių paieška

Ieškokite Lietuvos įmonių pagal pavadinimą, juridinio asmens kodą arba PVM mokėtojo kodą su pažangiais filtrais ir fuzzy paieška.

Parametrai

PavadinimasTipasBūtinasAprašymas
qstringBūtinasPaieškos užklausa - įmonės pavadinimas, kodas ar PVM numeris (minimum 2 simboliai)
includeRiskbooleanNeprivalomasĮtraukti rizikos vertinimo duomenis į atsakymą
limitnumberNeprivalomasMaksimalus rezultatų skaičius (1-50, pagal nutylėjimą 10)

Pavyzdžiai

Paieška pagal pavadinimą
Paieška pagal pavadinimą
curl -H "Authorization: Bearer ak_live_jūsų_raktas" \
  "https://credora.lt/api/companies/search?q=technologijos&includeRisk=true&limit=10"
JavaScript
JavaScript
const response = await fetch('https://credora.lt/api/companies/search?q=UAB&includeRisk=true', {
  headers: {
    'Authorization': 'Bearer ak_live_jūsų_raktas',
    'Content-Type': 'application/json'
  }
});

if (!response.ok) {
  throw new Error(`HTTP error! status: ${response.status}`);
}

const data = await response.json();
console.log('Rasta įmonių:', data.data.results.length);
Python
Python
import requests

headers = {
    'Authorization': 'Bearer ak_live_jūsų_raktas',
    'Content-Type': 'application/json'
}

try:
    response = requests.get(
        'https://credora.lt/api/companies/search',
        params={'q': 'UAB', 'includeRisk': True, 'limit': 20},
        headers=headers
    )
    response.raise_for_status()
    
    data = response.json()
    print(f"Rasta įmonių: {len(data['data']['results'])}")
    
    for company in data['data']['results']:
        print(f"- {company['pavadinimas']} ({company['ja_kodas']})")
        
except requests.exceptions.RequestException as e:
    print(f"Klaida: {e}")

Atsakymo pavyzdžiai

GET/companies/{ja_kodas}

Įmonės detali informacija

Gaukite išsamią informaciją apie konkrečią įmonę pagal jos juridinio asmens kodą, įskaitant finansinius duomenis ir rizikos analizę.

Parametrai

PavadinimasTipasBūtinasAprašymas
ja_kodasstringBūtinasĮmonės juridinio asmens kodas (9 skaitmenys)
includeFinancialsbooleanNeprivalomasĮtraukti finansinius duomenis į atsakymą

Pavyzdžiai

Pilnos įmonės informacijos gavimas
Pilnos įmonės informacijos gavimas
curl -H "Authorization: Bearer ak_live_jūsų_raktas" \
  "https://credora.lt/api/companies/123456789?includeFinancials=true"
JavaScript
JavaScript
async function getCompanyDetails(jaKodas) {
  try {
    const response = await fetch(`https://credora.lt/api/companies/${jaKodas}?includeFinancials=true`, {
      headers: {
        'Authorization': 'Bearer ak_live_jūsų_raktas'
      }
    });
    
    if (!response.ok) {
      if (response.status === 404) {
        throw new Error('Įmonė nerasta');
      }
      throw new Error(`API klaida: ${response.status}`);
    }
    
    const data = await response.json();
    return data.data;
  } catch (error) {
    console.error('Klaida gaunant įmonės duomenis:', error);
    throw error;
  }
}

// Naudojimas
const company = await getCompanyDetails('123456789');
console.log(`Įmonė: ${company.company.pavadinimas}`);
console.log(`Rizikos lygis: ${company.riskAssessment.overallRisk}`);

Atsakymo pavyzdžiai

Klaidų kodai

Šiame skyriuje pateikiami galimi API grąžinami klaidų kodai, jų reikšmės, paaiškinimai bei rekomendacijos, kaip spręsti ar išvengti kiekvienos klaidos.

HTTP KodasKlaidos KodasAprašymasSprendimas
400INVALID_QUERYNeteisingi užklausos parametraiPatikrinkite parametrų formatus ir reikšmes
401UNAUTHORIZEDNeteisingas arba trūkstamas API raktasĮtraukite teisingą Authorization antraštę
404COMPANY_NOT_FOUNDĮmonė su nurodytu kodu nerastaPatikrinkite juridinio asmens kodą
429RATE_LIMITViršytas užklausų limitasPalaukite arba atnaujinkite planą
500INTERNAL_ERRORVidaus serverio klaidaSusisiekite su palaikymo komanda

Rizikos vertinimas

Mūsų AI algoritmas analizuoja įmonių riziką remiantis oficialiais duomenimis ir suteikia išsamų vertinimą.

Išsamūs duomenys

Prieiga prie pilnų įmonių profilių iš oficialių Lietuvos registrų su reguliariu atnaujinimu.

Rizikos vertinimas

AI pagrindu veikiantis rizikos analizės algoritmas, vertinantis bankrotus, mokesčių skolas ir atitiktį.

Realaus laiko duomenys

Duomenys atnaujinami reguliariai iš oficialių šaltinių su 99.9% veikimo laiku.

Protinga paieška

Pažangus paieškos algoritmas su klaidų toleravimu ir intelektualiu atitikimu.

Paprastas API

REST API su išsamia dokumentacija ir pavyzdžiais įvairioms programavimo kalboms.

Analitika

Išsamūs duomenų kokybės rodikliai ir naudojimo statistika jūsų projektams.

Duomenų šaltiniai

Mūsų duomenys kaupiami iš oficialių Lietuvos valstybės registrų ir atnaujinami kasdien.

Pirminiai šaltiniai

  • • Juridinių asmenų registras
  • • Bankrotų registras
  • • Valstybinė mokesčių inspekcija
  • • Statistikos departamentas

Duomenų kokybė

  • • 99.9% duomenų tikslumo lygis
  • • Reguliarūs atnaujinimai
  • • Automatinis duomenų patikrinimas
  • • Istorinių duomenų saugojimas

Pagalba

Reikia pagalbos? Mūsų komanda visada pasiruošusi jums padėti su API integravimu ir naudojimu.

Susisiekite su mumis

El. paštas:info@credora.lt
Telefonas:
+370 600 12345