Перейти до вмісту
Увійти
UK

Підключення докладно Пошук помилок у підключеннях

Найгірше повідомлення про помилку — те, якого ніколи немає

Програма, яка падає, дратує. Програма, яка показує повідомлення про помилку, неприємна. Програма, яка мовчить і нічого не знаходить, небезпечна — бо ніхто не помічає, що щось зламане.

При розпізнаванні того, хто телефонує, це має такий вигляд: телефон дзвонить, плитка запитує CRM, CRM відповідає порожнім списком, плитка показує «Невідомий». Усе працює. Усе зелене. І все одно ніщо не є правильним.

200 OK
Код стану, яким інтерфейс може відповісти й тоді, коли запит насправді не вдався. Щонайменше в однієї системи з каталогу справжня помилка стоїть у тілі відповіді.

Три шляхи, якими з’єднання стає тихо хибним

Перше: шукали не в тому місці

Одна програма для адвокатських контор пропонує повнотекстовий пошук серед контактів. У її довідці сказано, що він особливо корисний, коли телефонує клієнт і є лише телефонний номер. В описі ж інтерфейсу сказано тільки, що шукане слово «застосовується до різних полів контакту».

Саме до яких — не сказано ніде. Якби телефонних номерів серед них не було, повідомлення про помилку не прийшло б. Прийшов би порожній список — при кожному дзвінку, тижнями, і ніхто не запідозрив би пошук.

Тому ми там запитуємо, а не пробуємо. Спроба не змогла б відрізнити «шукали не там» від «цього немає».

Друге: поле пошуку було знехтуване

Найнеприємніший випадок — і саме він спричинив у нас появу захисту.

Одна скандинавська CRM приймає свої пошуки через загальний виклик, у якому відіграє роль назва поля пошуку. Якби ця назва була хибною, мислимі були б дві відповіді: повідомлення про помилку — або просте обминання невідомого поля.

У другому випадку повернувся б увесь масив, зі станом 200. Плитка показала б тоді як того, хто телефонує, перший-ліпший запис.

Відтоді є вартовий: після відповіді перевіряється, чи номер знахідки справді збігається з шуканим. Що не підходить, відпадає, і в журналі записано, що відпало. Помилка заявляє про себе сама, замість того щоб мовчки привітати не ту людину.

Третє: помилка стоїть у тілі відповіді

Одна німецька програма для маклерів відповідає на хибний вхід звичайною помилкою HTTP. Помилку ж при обробці — наприклад, брак права на адресний модуль — вона повідомляє в тілі відповіді, зі станом 200.

Без остороги брак права виглядав би тому точно так само, як «номера там немає»: порожній список, жодного повідомлення.

Портал тепер перевіряє цей код навмисно. При налаштуванні різниця між «немає прав» і «нічого не знайдено» — половина пошуку причини, а без неї підозра падає на CRM клієнта, де їй не місце.

Чому ми радше запитаємо, ніж гадатимемо

Тому в кожному запиті до виробника програм стоїть абзац, який пояснює, чому ми взагалі пишемо, а не просто починаємо:

Це не недовіра до виробника. Це розуміння того, що з’єднання, яке мовчки нічого не знаходить, гірше, ніж жодного — про «жодного» принаймні знають усі.

За чим це помітити у власному підприємстві

Хто користується розпізнаванням тих, хто телефонує, і підозрює, що воно впізнає надто мало, нехай перевірить у такому порядку:

  • Чи переглядаються всі телефонні поля, чи лише перше?
  • Чи порівнюється знак за знаком, чи за цифрами?
  • Чи приходить на навмисно хибний запит помилка, чи порожній список?
  • Чи стоїть щось у журналі, коли нічого не знайдено, — чи взагалі нічого?

Останнє питання найважливіше. Систему, яка не занотовує власної невдачі, перевірити неможливо.

Часті запитання

Чому ви просто не спробуєте інтерфейс?

Тому що невдала спроба тут не впадає в око як помилка. Пошук, який не переглядає телефонні номери, відповідає не помилкою — він відповідає порожнім списком. Це виглядає як «того, хто телефонує, там немає».

Що таке вартовий?

Перевірка після відповіді: знахідка показується лише тоді, коли її номер справді збігається з шуканим. Якщо чужа система обходить наше поле пошуку і видає весь масив, відпадає все, що не підходить, — а в журналі записано, що це сталося.

Хіба HTTP 200 не означає, що все гаразд?

Ні. Деякі інтерфейси завжди відповідають 200 і вміщують результат у тіло відповіді. Брак права виглядає тоді точно так само, як «нічого не знайдено», — доки не зазирнути в тіло навмисно.

Що це означає для налаштування?

Що різниця між «немає прав» і «нічого не знайдено» — половина пошуку причини. Без цієї різниці хтось шукає півдня — а підозра падає на CRM клієнта.

Як працює плитка Усі підключення

Поговоріть з нами

Ви отримаєте не типове рішення, а чітку оцінку: чи виправдані зусилля для вашої компанії, що для цього має вміти ваша система — і скільки це коштує. Якщо не підходить, ми так і скажемо.