API-liidestus
Soovid, et veebilehelt tulnud päring jõuaks automaatselt CRM-i, laoseis klapiks tarneahela süsteemiga ja ostja näeks iseteeninduses tellimuse staatust. API-liidestus lahendab just sellised olukorrad: ühendab kaks teenust nii, et andmed liiguvad automaatselt, ilma käsitsi kopeerimiseta. Alusta oma stsenaariumide loetlemisest: mis andmed, kuhu ja kui tihti liikuma peavad ning mis on õnnestunud tulemus.
Päringuvormi jaoks kogu mõlema poole dokumentatsioon, näidis päringust ja vastusest ning väljade kirjeldus. Täpsusta, milliseid andmeid sünkroonida: näiteks tellimuse number, tootekood, kogus, makse staatus. Kui teenusel on piirangud päringute sagedusele või andmevormingule, märgi need varakult. Kirjelda ka, kes annab ligipääsu ja milliseid võtmeid vaja on. Ära saada töötavaid paroole avatud kujul — leppige kokku turvaline viis.
Töö vastuvõtmisel kontrolli lisaks õnnestunud andmevahetusele ka käitumist tõrgete korral. Mis juhtub, kui teenus on ajutiselt kättesaamatu? Kas korduspäring toimub ja kas tellimus võib dubleeruda? Kuidas saad veast teada — logi, teavituse või aruande kaudu? Palu näidata logimist ja selgitada, kus võtmeid hoitakse ning kellel on neile ligipääs. Kasulik on läbi mängida stsenaarium testkeskkonnas ja veenduda, et andmed ei lähe kaduma.
Et lähteülesanne oleks terviklik, lisa teenuste nimed, lingid dokumentatsioonile, näited andmetest ja soovitud vahetuse graafik. Kirjelda, kes tellija poolel kinnitab ligipääsud ja kontrollib tulemust. Kui mõtled vigade ja piirangute peale juba enne töö algust, on täitjal lihtsam pakkuda vastupidavat lahendust ning sinul tööd vastu võtta ilma üllatusteta.
Avalda ülesanne või paku oma teenust.