Failų eksportas tinka vienkartiniam darbui, bet jei jūsų CRM ar ERP turi pats pildytis įmonių duomenimis, verta jungtis per API. Štai kaip tai atrodo praktiškai.
Kada rinktis API, o kada failą
- Failas (CSV, JSON, XML) – vienkartinis sąrašas kampanijai ar analizei.
- API – kai duomenys turi atsirasti automatiškai: pavyzdžiui, įvedus įmonės kodą naujame užsakyme, užpildomi pavadinimas, adresas ir vadovas.
Autorizacija
Kiekviena užklausa autorizuojama API raktu, kurį siunčiate Authorization antraštėje. Raktą laikykite serveryje, o ne naršyklės kode, ir niekam neperduokite.
Paprasta užklausa
Pavyzdžiui, norėdami sužinoti savo rakto naudojimo statistiką, siųstumėte GET užklausą:
curl --request GET 'https://1db.lt/api/private/api-key-stats' \
--header 'Authorization: Bearer YOUR_API_KEY'Atsakymas grįžta kaip JSON, todėl jį galima tiesiogiai skaityti bet kuria kalba. Pilną galinių taškų sąrašą, įskaitant filtravimą su puslapiavimu ir įrašo gavimą pagal įmonės kodą, rasite API dokumentacijoje.
Ką numatyti integruojant
- Užklausų limitą. Planai skiriasi užklausų skaičiumi per mėnesį – naudokite talpyklą, kad nekartotumėte tų pačių užklausų.
- Klaidų valdymą. Tinklo klaidos pasitaiko; pakartokite užklausą su pauze ir fiksuokite nesėkmes.
- Tuščius laukus. Ne visos įmonės turi kontaktus – kodas turi gražiai tvarkytis su tuščiomis reikšmėmis.
- Unikalų raktą. Įmonės kodą naudokite kaip pagrindinį raktą ir išvengsite dublikatų.
Kaip pradėti
- Pasirinkite planą ir įsigykite API raktą.
- Išbandykite užklausas su cURL ar savo kalba.
- Įdiekite talpyklą ir klaidų valdymą.
- Prijunkite prie CRM ar ERP.
Nesate tikri, kuris planas tinka? Pradėkite nuo mažiausio – užklausų limitą visada galima padidinti vėliau.