Když s vašimi leady potřebuje pracovat i jiný systém – firemní informační systém, aplikace dodavatele, nástroj partnera – vygenerujete přístup a předáte mu ho. Kód psát nemusíte, to je práce toho druhého systému.
K čemu to je
Typické případy z praxe:
- Partner nebo dodavatel si sám stahuje poptávky, které se ho týkají.
- Váš vlastní informační systém si tahá leady do reportů.
- Externí systém posílá zpátky změnu stavu, když si vyřídí zakázku sám.
Modul funguje samostatně, nezávisle na tom, které další moduly máte zapnuté. A pozor, nezaměňujte ho s měřicím kódem na webu – ten má vlastní klíč a řeší se jinde.
Vygenerování přístupu
V menu API pro leady . Uvidíte, že přístup zatím není aktivní, a tlačítko Vygenerovat API přístup .
Po kliknutí se objeví žlutý box s API klíčem a API heslem a tlačítkem Kopírovat údaje .
Heslo se ukáže jenom teď
Zkopírujte si ho hned a uložte na bezpečné místo, ideálně do správce hesel. V aplikaci se ho už nikdy nedozvíte – v databázi je jen jeho otisk. Když se ztratí, musíte přístup přegenerovat a partnerovi předat nové údaje.
Později uvidíte na stránce jen zkrácený klíč a dvě tlačítka: Přegenerovat klíč + heslo a Vypnout přístup .
Co předat partnerovi
Kromě klíče a hesla mu pošlete odkaz na tuhle stránku v aplikaci – je na ní přesný seznam adres i ukázka volání. Ve zkratce jde o tohle:
- Seznam leadů – dá se stránkovat, filtrovat podle fáze a stahovat jen to, co se od minule změnilo.
- Detail jednoho leadu.
- Odeslání změn – včetně možnosti přidat poznámku.
- Vytvoření a smazání leadu.
Klíč i heslo se posílají v hlavičkách X-Api-Key a X-Api-Secret.
Ukázkové volání vypadá takhle:
curl -H "X-Api-Key: VAS_KLIC" \
-H "X-Api-Secret: VASE_HESLO" \
"https://app.leadinka.cz/api/v1/leads?per_page=50"Partner vidí jen leady tohoto jednoho projektu. Když máte projektů víc, potřebuje přístup do každého zvlášť.
Bezpečnost
- Heslo je v databázi jen jako otisk, nikdo ho z ní nepřečte.
- Klíč je vázaný na jeden projekt, cizí data se přes něj dostat nedají.
- Je nastavený limit 120 požadavků za minutu, aby vám API nikdo nepřetížil.
- Tlačítko Vypnout přístup ho zablokuje okamžitě.
Pár zvyků, které se vyplatí
Neposílejte údaje běžným e-mailem – lepší je zavolat, nebo použít nástroj na jednorázové sdílení hesla. A když spolupráce s partnerem skončí, přístup rovnou přegenerujte nebo vypněte. Trvá to vteřinu a ušetří to nepříjemné otázky.