Miksi APIesi kannattaisi olla API-tuotteita?

Mikä on onnistuneen API-ohjelman salaisuus?

Tämä on kysymys, jota API-ammattilaisilta usein kysytään. Vaikka vastaukset tähän kysymykseen voivat vaihdella, useimmat API-asiantuntijat ovat yhtä mieltä siitä, että APIen tulisi saada sama huomio kuin mihin tahansa muuhun tuotteeseen. Mutta mitä se tarkoittaa?

Katsotaanpa asiaa tällä tavalla: Monilla organisaatioilla on satoja pisteestä pisteeseen -integraatioita, jotka kaikki ovat ainutlaatuisia tietylle asiakkaalle. Kukaan ei ole ajan tasalla siitä, kuinka monta niitä on, mihin niitä käytetään tai mitä ongelmia ne ratkaisevat. Lisäksi kukaan ei uskalla tarttua haasteeseen selvittää tämä. Jos tämä olisi tilanne minkä tahansa muun yrityksen tuotelinjan kanssa, johto olisi puuttunut asiaan jo kauan sitten.

Miksi API-tuotteiden suunnittelu kannattaa?

1. Auttaa tunnistamaan kuluttajat ja todelliset käyttäjät - Jokaisella tuotteella on kohderyhmä. Sovellusliittymien avulla on yhtä tärkeää ymmärtää, kuka ostaa ja käyttää rajapintojasi.

2. Selventää, mitä käyttäjät haluavat ja arvostavat - APIn tulisi vastata kohderyhmäsi tarpeisiin. Mikä on liiketoimintaongelma, jonka he haluavat ratkaista APIsi avulla?

3. Auttaa tunnistamaan API-kuluttajien ja kumppaneiden yhteiset tarpeet — Tunnistamalla nämä yhteiset tekijät, voit yksinkertaistaa API-katalogiasii.

4. Keskittyy pakkauksiin — rajapintasi tulisi suunnitella ja kuvata tavalla, jota sekä ihmiset että koneet ymmärtävät. Tämä sisältää esimerkiksi API-hallintatyökalut, yhdyskäytävät, API-turvallisuus- ja koodaustyökalut.

‍

Miksi API-tuote tarvitsee arvolupauksen?

‍

Joskus tuotetiimi vastaa APIn kehittämisestä osana ”todellista” tuotetta.

Joskus API on varsinainen tuote.

Ensimmäinen tapaus on vaikeampi, koska API voi päätyä toisen luokan kansalaiseksi. Se on tavallaan tuolla koska ”meillä on oltava API”.

Tämä johtaa useisiin kysymyksiin:

• Miksi se on olemassa?
• Mihin asiakkaamme käyttävät sitä?
• Mitä meidän pitäisi lisätä siihen?
• Onko se arvokasta meille ja asiakkaillemme tai yhteistyökumppaneille?

Myyjäsi eivät ole Han Solo eivätkä asiakkaasi Sherlock Holmes.

Myyjäsi viettävät vain lyhyen ajan määrittämään, mitä asiakkaan tulisi tehdä APIllasi. Jos he kohtaavat hyvin yleisen, teknisen tai olemattoman kuvauksen siitä, mitä etuja, käyttötapauksia tai laajasti sanottuna sovellusliittymän arvo heille on, he eivät vain välitä. He mieluummin jättävät väliin puhumisen APIsta tai vetävät aina kehittäjät, tuotepäälliköt tai ketä tahansa, jonka he voivat saada käsiinsä myyntipalavereihin selittämään asioita.

Mutta todellinen asia on, että rajapintasi pitäisi olla yksinkertainen. Henkilö (kehittäjä, arkkitehti, liiketoiminnan kehittäjä jne.), joka on kiinnostunut tietyn ongelman ratkaisemisesta tai tehtävän suorittamisesta, voisi alkaa käyttää sitä välittömästi.