Palvelusi näkyy tuntemattomana, jos siltä puuttuu rajapintakuvaus liityntäpalvelimen hallintakäyttöliittymästä Palveluväylässä. Ilman rajapintakuvausta Liityntäkatalogi ei voi tunnistaa, onko palvelusi REST- vai SOAP-muotoinen.
Yleensä tuntematon palvelu on REST-palvelu, joka on lisätty REST API Base Path -muotoisena Palveluväylään. Liityntäkatalogi ei tunnista REST API Base Path -polulla lisättyjä REST-palveluja. REST-palvelulla täytyy olla OpenAPI 3 -muotoinen rajapintakuvaus, jotta Liityntäkatalogi voi tunnistaa sen.
Suosittelemme lisäämään REST-palvelut Palveluväylään käyttämällä OpenAPI 3 Description -polkua liityntäpalvelimen hallintakäyttöliittymässä. Tällöin Liityntäkatalogi tunnistaa palvelun ja näyttää rajapintakuvauksen automaattisesti. Vaikka et voisi julkaista rajapintakuvausta OpenAPI 3 -muodossa, suosittelemme silti lisäämään kuvauksen esimerkiksi liitetiedostona.
Jossain tapauksissa SOAP-palvelulta saattaa kadota WSDL-kuvaus, jolloin se näkyy myös tuntemattomana palveluna.
Lue lisää palveluiden teknisestä kuvaamisesta.
