За собственика на бизнеса: какво е API ключ и как давате достъп на друг софтуер
Тази страница е за вас, ако някой — фулфилмънт център, счетоводен или складов софтуер, CRM, AI асистент — ви е помолил за „API ключ" или „достъп до velik.ai". Тук няма код. Техническата документация за програмиста е на velik.ai/developers.
Какво е API ключ
API ключът е парола за софтуер. С него друга програма може да чете и променя данни във вашия акаунт в velik.ai — само тези данни, за които ключът е издаден, и само във вашия акаунт. Ключът не дава вход в админа, не вижда други мърчанти и не може да сменя плана или плащанията ви.
Ключът се показва веднъж при издаването. След това velik.ai пази само началото му (напр. vk_ab12cd34), за да го разпознавате в списъка, и кога е ползван за последно.
Какво дава всеки „пресет"
При издаване избирате какво може ключът. Изборът е задължителен и не се променя после (ако трябва друг обхват — издавате нов ключ и спирате стария).
| пресет | какво може | на кого се дава |
|---|---|---|
| 📦 Фулфилмънт | вижда поръчките и ги маркира като приети / изпратени с номер на пратка; издава и анулира товарителници през вашите куриерски интеграции; записва доставки и корекции в склада; вижда каталога; получава известия за нови поръчки и промени | фулфилмънт център, склад, WMS |
| 👁 Само четене | вижда поръчки, пратки, склад, продукти, клиенти и известията — нищо не променя | счетоводител, отчети, BI |
| ⚙️ Персонализиран | точно избраните от вас възможности (напр. само поръчки; или и продукти — цена, име, SKU; или сегменти и бележки за клиенти) | всичко друго, вкл. AI асистент |
| 🔗 МАШИНАТА | само мостът към МАШИНАТА (брифове и статус) | ако ползвате МАШИНАТА |
Нито един ключ не може: да изтрива поръчки или клиенти, да променя имейли/телефони/съгласия на клиенти, да сменя наличности „на ръка" без движение в склада, да качва снимки, да вижда себестойност или платежни данни.
Как давате достъп на фулфилмънт център (5 минути)
- Влезте като собственик на акаунта (членове на екипа не издават ключове).
- Настройки → 🔌 Интеграции → API ключове → ➕ Издай ключ.
- Име: напишете кой ще го ползва (напр. „Фулфилмънт X"). Пресет: 📦 Фулфилмънт.
- Копирайте ключа и го пратете на центъра по сигурен канал (не в общ чат, не в имейл до много хора). Той се показва само сега.
- По желание: в същия екран, секция 📡 Webhooks, центърът може да поиска да добавите неговия адрес за известия — или го прави сам с ключа си.
- Проверка: след първата им заявка в списъка ще видите „последно ползван".
Планът трябва да е Pro или по-висок — на Free ключът се издава, но заявките се отказват.
Как спирате достъпа
Настройки → 🔌 Интеграции → API ключове → Оттегли до ключа. Действа веднага: следващата заявка на софтуера получава отказ. Оттегленият ключ остава в списъка като история. Ако сте дали и webhook адрес — изключете го или го изтрийте от секция 📡 Webhooks.
Съмнявате се, че ключ е изтекъл? Оттеглете го и издайте нов — това е цялата процедура. Няма нужда да сменяте паролата на акаунта.
Какво получава софтуерът за вас (известията)
Когато има нова поръчка, сменен статус, издадена или анулирана товарителница, плащане или ниска наличност, velik.ai може да уведоми софтуера ви сам (webhook), вместо той да пита на всеки няколко минути. Всяко известие е подписано, така че получателят знае, че идва от velik.ai, и се повтаря при неуспех до 6 пъти в рамките на ~15 часа. Ако адресът спре да отговаря, получавате имейл от velik.ai.
Какво да кажете на програмиста
Пратете му линка velik.ai/developers (английски) или velik.ai/developers/bg (български). Там има бърз старт за 5 минути, пълен справочник, готови примери и всички правила. Въпроси: support@velik.ai.
Generated from docs/integrations/ in the velik.ai repository. Contract: /openapi.v1.yaml · API справочник · Postman collection · Privacy · Terms