Когато документите започват в друга система

Въпросът, който възниква на втората среща: „интегрирате ли се с нашата система?“. Досега честният отговор беше не. Сега отговорът е този: имате портал, CRM или счетоводна система, в която сделката вече съществува, и DocuTract може да работи като част от нея.

Шестата функция от вълната е изходът навън. Токен, с който вашата система се обръща към нас, адрес, на който пишем по собствена инициатива, и открито описание на всичко помежду им.

Токен, който не можем да ви покажем два пъти

Токенът се създава на екрана Интеграции: име, което ще разпознаете по-късно, за да знаете коя система го използва, и списък с това, което му е позволено. След това се показва веднъж.

Това не е забравяне, а начинът, по който трябва да работи продукт, който държи чужд ключ. Пазим само хеш: да покажем токена втори път не можем дори ние, което означава, че той не може да бъде откраднат от нас. Списъкът пази първите знаци, правата и датата на последното използване, така че се вижда кой токен е жив и дали някой все още го използва.

Отмени го изключва мигновено. Записът за него остава: това, че е съществувал и кога е спрял да работи, е част от историята на работното пространство, а не боклук.

Правата се проверяват за всеки адрес поотделно. Токен, на който е позволено само да чете шаблони, получава ясно „липсва обхватът documents:write“, когато се опита да създаде документ, а не празно „не е намерено“. Приемаме, че интеграцията я свързва жив човек, а отговор, който не обяснява нищо, му струва цяла вечер.

Какво може API

Колкото можете и на екрана, само че без екрана: да отворите дело и да качите сканове в него, да създадете документ от шаблон с вече попълнени стойности, да попитате до кой етап е стигнал, да вземете всяка стойност заедно със скана, от който е прочетена, и да получите краткотраен линк към готовия файл.

Тази последна част прави тази интеграция различна от другите. Вашата система получава не просто попълнен файл, а всяка стойност с нейния произход: скана, полето, доколко уверено е било разчитането. Същият източник, който човек вижда на екрана за проверка, е достъпен и за кода.

Описанието на всеки адрес и поле се генерира от самия код и се публикува открито, без токен: /api/v1/openapi.json. Документация, която първо трябва да поискате, е документация, която никой не чете.

Уебхукове и честен журнал

Не е нужно да ни питате дали документът е готов. Дайте ни адрес и отметнете събитията: документът е готов, документът е неуспешен, делото е готово, открито е разминаване, клиент е изпратил файл.

Всяка заявка е подписана, а тайният ключ, с който се проверява подписът, се показва веднъж, както токенът. Ако сървърът ви е отговорил с нещо друго или изобщо не е отговорил, опитваме отново: след минута, след пет, след половин час, след два часа и след десет. След това спираме, защото интеграция, която никой не поддържа, не бива да хаби нечии ресурси безкрайно.

А сега частта, заради която е написано всичко това. Когато другата страна каже „нашата система не получи нищо“, отговорът е на екрана: събитието, часът, колко опита, какъв код на отговор се е върнал и началото на тялото на отговора. Вижда се, че тя е отговорила с 500 пет пъти. Това не е помощно средство за отстраняване на грешки за нас, а отговор за вашия инженер.

До него - два бутона за часа, в който интеграцията още се настройва. Изпрати тест изпраща пробна заявка веднага, без да чака реално събитие, така че получателят да може да бъде проверен, преди през него да мине каквато и да е работа. Опитай отново до неуспешна доставка прави още един опит незабавно и не нулира историята: четирите неуспешни опита остават в записа, защото това е истината за това колко е струвало това известие.

Ограниченията, които сме си наложили

Уебхукът отива само към https и само към публичен адрес: адрес в частна мрежа се отказва както при запазването, така и преди всеки опит, защото име на хост, което вчера сочеше навън, днес може да сочи навътре. Ограничението на честотата се брои за токен, а не за адрес, така че съсед на същия сървър не изразходва вашия лимит, а при превишаването му получавате честно „върнете се след толкова секунди“.

API и уебхуковете са част от план Team. Ако работно пространство премине към друг план, вече създаденото остава видимо и може да бъде отменено: ключове, до които никой не може да стигне, са по-лоши от платена функция.

Какво не влиза в тази версия

Заданието за тази фаза описваше още две части: експорт на готов документ в Google Drive, OneDrive или Dropbox и изпращането му за подпис чрез DocuSign или Dropbox Sign. И двете изискват идентификационни данни от тези доставчици, каквито в момента нямаме, а да напишем интеграция, която не може да бъде тествана никъде, означава да представим ненаписан код като завършен. Те остават в плана като отделни версии.

Какво следва

Седмата и последна функция от вълната е масовото генериране: списък от петдесет реда или архив със сканове вместо петдесет еднакви ръчни попълвания, с видим напредък и възможност да повторите само неуспешните.

Целият списък е в какво създаваме след това, а инструкциите стъпка по стъпка за интеграциите са в центъра за помощ.