Ohjelma, joka kaatuu, on ärsyttävä. Ohjelma, joka näyttää virheilmoituksen, on epämiellyttävä. Ohjelma, joka vaikenee eikä löydä mitään, on vaarallinen – koska kukaan ei huomaa, että jokin on rikki.
Soittajan tunnistuksessa se näyttää tältä: puhelin soi, ruutu kysyy CRM-järjestelmältä, CRM vastaa tyhjällä listalla, ruutu näyttää «Tuntematon». Kaikki toimii. Kaikki on vihreää. Ja silti mikään ei ole oikein.
Kolme tietä, joita pitkin liitäntä muuttuu hiljaa vääräksi
Ensiksi: haettu väärästä paikasta
Eräs asianajotoimistoille tarkoitettu ohjelma tarjoaa yhteystietojen kokotekstihaun. Sen ohjeessa lukee, että se on erityisen hyödyllinen silloin, kun päämies soittaa ja käytettävissä on vain puhelinnumero. Rajapinnan kuvauksessa lukee sen sijaan vain, että hakusana «kohdistetaan yhteystiedon eri kenttiin».
Mihin niistä, sitä ei lue missään. Jos puhelinnumerot eivät olisi niiden joukossa, ei tulisi mitään virheilmoitusta. Tulisi tyhjä lista – jokaisella puhelulla, viikkokausia, ilman että kukaan epäilisi hakua.
Siksi kysymme siellä sen sijaan, että kokeilisimme. Yritys ei pystyisi erottamaan «haettu väärin» ja «ei ole olemassa» toisistaan.
Toiseksi: hakukenttä ohitettiin
Epämiellyttävin tapaus – ja juuri se sai meillä aikaan suojauksen.
Eräs pohjoismainen CRM ottaa hakunsa vastaan yleisen kutsun kautta, jossa hakukentän nimellä on merkitystä. Jos tämä nimi olisi väärä, kaksi vastausta olisi ajateltavissa: virheilmoitus – tai yksinkertainen tuntemattoman kentän sivuuttaminen.
Jälkimmäisessä tapauksessa palaisi koko aineisto, tilalla 200. Ruutu olisi silloin näyttänyt soittajana ensimmäisen vastaan tulleen merkinnän.
Siitä lähtien on vartija: vastauksen jälkeen tarkistetaan, täsmääkö osuman numero todella haetun kanssa. Mikä ei sovi, putoaa pois, ja lokissa lukee, että se putosi pois. Virhe ilmoittautuu näin itse, sen sijaan että se tervehtisi hiljaa väärää ihmistä.
Kolmanneksi: virhe on rungossa
Eräs saksalainen välittäjäohjelma vastaa väärään kirjautumiseen tavallisella HTTP-virheellä. Käsittelyn virheen – esimerkiksi osoitemoduulista puuttuvan oikeuden – se ilmoittaa sen sijaan vastauksen rungossa, tilalla 200.
Ilman varovaisuutta puuttuva oikeus näyttäisi siksi täsmälleen samalta kuin «numeroa ei ole siellä»: tyhjä lista, ei ilmoitusta.
Portaali tarkistaa tämän koodin nyt nimenomaisesti. Käyttöönotossa ero «ei oikeutta» ja «ei löytynyt mitään» välillä on puolet syyn etsinnästä – ja ilman sitä epäily kohdistuu asiakkaan CRM-järjestelmään, jonne se ei kuulu.
Miksi kysymme mieluummin kuin arvaamme
Jokaisessa ohjelmistotalolle osoitetussa tiedustelussa on siksi kappale, joka selittää, miksi kirjoitamme sen sijaan että vain aloittaisimme:
Tämä ei ole epäluottamusta valmistajaa kohtaan. Tämä on oivallus, että liitäntä, joka hiljaa ei löydä mitään, on pahempi kuin ei liitäntää lainkaan – puuttumisen tuntee ainakin jokainen.
Mistä sen huomaa omassa yrityksessä
Se, joka käyttää soittajan tunnistusta ja epäilee sen tunnistavan liian vähän, tarkistaa parhaiten tässä järjestyksessä:
- Käydäänkö läpi kaikki puhelinkentät vai vain ensimmäinen?
- Verrataanko merkki merkiltä vai numeroiden perusteella?
- Tuleeko tahallaan väärästä kyselystä virhe vai tyhjä lista?
- Lukeeko lokissa jotain, kun mitään ei löytynyt – vai ei yhtään mitään?
Viimeinen kysymys on tärkein. Järjestelmää, joka ei merkitse muistiin omaa epäonnistumistaan, ei voi tarkistaa.
Usein kysytyt kysymykset
Miksi ette yksinkertaisesti kokeile rajapintaa?
Koska epäonnistunut yritys ei täällä pistä silmään virheenä. Haku, joka ei käy läpi puhelinnumeroita, ei vastaa virheellä – se vastaa tyhjällä listalla. Se näyttää siltä kuin «soittajaa ei ole siellä».
Mikä on vartija?
Tarkistus vastauksen jälkeen: osuma näytetään vasta silloin, kun sen numero todella täsmää haetun kanssa. Jos vieras järjestelmä kiertää hakukenttämme ja luovuttaa koko aineiston, putoaa pois kaikki, mikä ei sovi – ja lokissa lukee, että näin tapahtui.
Eikö HTTP 200 tarkoita, että kaikki on kunnossa?
Ei. Jotkin rajapinnat vastaavat aina 200 ja asettavat tuloksen vastauksen runkoon. Puuttuva oikeus näyttää silloin täsmälleen samalta kuin «ei löytynyt mitään» – kunnes rungosta katsotaan nimenomaisesti.
Mitä se merkitsee käyttöönotolle?
Että ero «ei oikeutta» ja «ei löytynyt mitään» välillä on puolet syyn etsinnästä. Ilman tätä eroa joku etsii puoli päivää – ja epäily kohdistuu asiakkaan CRM-järjestelmään.