Asiakkaasi haluaa varaamisen osaksi omaa sivustoaan tai myyntitiedot omaan järjestelmäänsä. Johkun Partner API:lla rakennat sen suoraan Johkun tuotteiden, saatavuuden, hintojen ja tilausten varaan, etkä tee varauslogiikkaa tai maksamista itse. Rajapinnan käyttö edellyttää kumppanisopimusta, joten aloita liittymällä Johkun kumppaniohjelmaan.
Liity kumppaniohjelmaan Avaa Partner API:n dokumentaatio
Rakennat Partner API:lla esimerkiksi
Tuotteet ja saatavuus omaan ratkaisuusi
Haet kaupan tuotteet, tuoteryhmät, hinnat ja vapaat ajat kaupan omilla kielillä ja näytät ne asiakkaasi sivustolla juuri niin kuin haluat.
Varaus rakentamassasi käyttöliittymässä, maksu Johkussa
Kysyt hinnan, pidät paikat varattuina 30 minuuttia ja ohjaat ostajan maksamaan kaupan omalle tilaussivulle. Tilaus syntyy kauppiaan Johkuun ja näkyy myyntiraportissa integraatiosi nimellä. Sinä et käsittele maksuja.
Tilaukset ja myynti muihin järjestelmiin
Haet muuttuneet tilaukset, tulevat varaukset ja myyntiraportit asiakkaasi raportointiin tai omaan sovellukseesi.
Vahvistetut varaukset, kun myyt itse
Jos myyt kauppiaan tuotteita omassa palvelussasi ja otat maksun itse vastaan, luot vahvistetun varauksen suoraan kauppiaan Johkuun. Kauppias myöntää tämän oikeuden erikseen.
Rajapinta, jonka koodaava AI-avustajasi lukee itse
Partner API on dokumentoitu niin, että sen lukee yhtä hyvin koodaava AI-avustajasi kuin sinä. Anna avustajallesi yksi osoite, niin se löytää loput.
llms.txt lähtöpisteenä
Osoitteessa api.johku.com/llms.txt on tiivis hakemisto AI-avustajille: mitä rajapinta tekee, miten tunnistaudutaan ja mistä opas, OpenAPI-kuvaus ja dokumentaatio löytyvät.
Integraatio-opas Markdownina
Opas on kirjoitettu kehittäjille ja koodaaville avustajille. Se käy läpi koko varauspolun: varausvaihtoehdot, varausrivit, hintakysely, ostoskori ja linkki kaupan tilaussivulle.
OpenAPI 3.1 -kuvaus
Yli 30 operaatiota ja yli 400 esimerkkiä yhdessä tiedostossa. Jokaisella operaatiolla on oma tunniste, joten generoit asiakaskirjaston suoraan kuvauksesta.
Vastaukset kertovat, mitä seuraavaksi lähetetään
Varausvaihtoehdot kertovat tuotekohtaisesti, mitkä kentät varausrivi tarvitsee. Avustajasi ei arvaa, vaan lukee sen vastauksesta.
Virheet koneelle, ei vain ihmiselle
Jokainen virhe palautuu samassa muodossa (RFC 9457) ja sisältää pysyvän koodin. Koodisi ja avustajasi haarautuvat koodin mukaan, eivät virhetekstin.
Avain kertoo omat rajansa
Yhdellä kutsulla näet, mikä kumppani, integraatio ja avain on käytössä, mitkä oikeudet sillä on ja mitkä sen kutsurajat ovat.
Hinnat ja säännöt tulevat aina Johkusta
Kauppias ylläpitää tuotteet, hinnat, saatavuuden ja varausehdot Johkussa. Rajapinta kertoo, mitä tuotteesta voi juuri nyt varata ja mihin hintaan, ja sinä rakennat lomakkeesi sen varaan. Kun kauppias muuttaa kausihintaa tai sulkee päivän, muutos näkyy toteutuksessasi ilman, että muutat koodia.
Tehty kehittäjän työtä varten
Testiavain ja testikauppa. Kokeilet koko varauspolun testikaupassa, jossa on keksityt tuotteet ja tilaukset, ennen kuin kytkeydyt yhteenkään oikeaan kauppaan.
Dokumentaatio, jossa ajat kutsut. Jokainen päätepiste ja skeema on kuvattu, ja testiavaimella ajat kutsut suoraan selaimessa.
Uusintayritys ei tee kahta varausta. Lähetät POST-kutsuissa Idempotency-Key-otsakkeen, jolloin katkennut ja uudelleen lähetetty kutsu palauttaa saman vastauksen.
Eri avaimet palvelimelle ja selaimeen. Selainavain toimii vain sallimistasi osoitteista ja vain tuotteiden, saatavuuden, ostoskorien ja Atlas-haun kutsuissa. Salainen avain pysyy palvelimellasi.
Kauppias päättää, mihin integraatiosi pääsee
Yhdenkään kaupan tiedot eivät ole käytössäsi ilman kauppiaan suostumusta. Kytkentä syntyy kahdella tavalla:
Lähetät käyttöoikeuspyynnön. Kauppias näkee integraatiosi nimen ja kuvauksen, pyytämäsi oikeudet ymmärrettävästi kuvattuina ja perustelusi, ja hyväksyy tai hylkää pyynnön.
Kytket itse. Kun rakennat asiakkaallesi ja sinulla on käyttäjätunnus hänen Johkussaan, kytket integraation siellä itse ja valitset, mitkä oikeudet otat käyttöön. Kytkentä on voimassa heti.
Kauppias voi perua kytkennän milloin tahansa. Asiakastietojen lukeminen on oma oikeutensa, ja jokainen yksittäisen asiakkaan tietojen haku kirjautuu kaupan lokiin.
Kauppias tarvitsee Johku Powerin tai Johku Maxin, jotta hänen kauppaansa voi kytkeä integraation.
Kauppapaikan ilme edistyneellä CSS:llä
Kaikkeen ei tarvita rajapintaa. Kun asiakkaasi myy Johkun kauppapaikalla, kirjoitat teeman päälle omat CSS-määrityksesi ja viimeistelet sivuston asiakkaasi ilmeeseen. Edistynyt CSS kuuluu Johku Poweriin ja Johku Maxiin.
Sivuhuomautus: Tämä sivusto on kokonaan Johkun kauppapaikka. Kaikki mitä täällä on tehty, on mahdollista myös sinulle.
Jos asiakkaallasi on jo oma sivusto, upotat Johkun tuotteet, haun ja ostoskorin sinne vaivattomimmin widgeteillä. Widgetit on mahdollista sovittaa sivuston ilmeeseen CSS:llä. Tuotetiedot päivittyvät niihin Johkusta automaattisesti.
Kehittäjänä saat samat edut kuin muutkin kumppanit
Kehittäjät ovat Johkun kumppaniohjelman jäseniä siinä missä konsultit ja toimistotkin. Rajapinta-avaimen lisäksi saat ohjelman kaikki edut.
Johku Maxin AI-työkalut asiakkaidesi Johkuissa
Kumppanina käytössäsi ovat Johku Maxin AI-kyvykkyydet (MCP-työkalut) kaikissa asiakkaidesi Johkuissa. Rakennat kaupan tuotteet ja sisällöt oman AI-avustajasi kanssa.
20 % palkkio
Kun asiakkaasi tilaa Johku Powerin tai Johku Maxin vuositilauksena ja valitsee sinut kumppanikseen, Johku maksaa sinulle 20 % ensimmäisen vuoden vuosimaksusta. Partner API edellyttää kauppiaalta juuri näitä tasoja. Uusinnoista ja kuukausitilauksista palkkiota ei makseta.
Katsaus neljännesvuosittain
Käymme kanssasi neljännesvuosittain läpi, mikä toimii ja mitä kehitämme seuraavaksi.
Lue kumppaniohjelman ehdot ja rajaukset
Näin pääset alkuun
Tapaaminen ja kumppanisopimus. Kerrot, mitä rakennat ja mitä rajapintoja tarvitset. Sovimme pelisäännöistä kumppanisopimuksessa.
Kumppanitili omaan Johkuusi. Johku avaa yrityksellesi kumppanitilin ja liittää siihen ensimmäisen jäsenen omistajana. Tätä varten tarvitset oman Johkun. Kun tili on valmis, kumppaninäkymä avautuu omaan Johkuusi.
Jäsenet, integraatiot ja avaimet. Omistaja lisää tiimisi muut jäsenet, kehittäjät ja omistajat, ja luo integraatiot. Kunkin integraation alla hallitset itse sen avaimia ja käyttöoikeuksia.
Testikauppa. Rakennat ja testaat testiavaimella koko toteutuksen testikaupassa ilman yhtään oikeaa kauppaa.
Pilotti. Kun toteutus toimii testikaupassa, pyydät Johkua aloittamaan pilotin. Tuotantoavaimet toimivat siitä alkaen, ja voit kytkeytyä rajattuun määrään kauppoja, oletuksena kolmeen.
Varmennus. Kun pilottikaupoissa on ollut oikeaa käyttöä, virheitä on vähän ja kauppiaat ovat tyytyväisiä, Johku varmentaa sinut. Kaupparaja poistuu, kutsurajat nousevat ja kauppiaat näkevät integraatiosi kohdalla Johkun varmennusmerkin.
Hyvä tietää
Rajapintaa ei voi käyttää ilman voimassa olevaa kumppanisopimusta.
Tarvitset oman Johkun. Kumppanitili, sen jäsenet, integraatiot ja avaimet hallitaan siellä.
Partner API lukee ja varaa. Se ei muuta kaupan tuotteita, hintoja tai asetuksia.
Tilaus- ja asiakastiedot kuuluvat kauppiaalle ja hänen asiakkailleen. Käytät niitä vain siihen, mistä olet kauppiaan kanssa sopinut.
Jos kauppiaan Power- tai Max-tilaus päättyy, yhteys kauppaan keskeytyy. Se jatkuu samoilla oikeuksilla, kun tilaus on taas voimassa.
Kaikkia tuotteita ei voi varata rajapinnan kautta. Sellaisesta tuotteesta rajapinta antaa linkin kaupan omalle varaussivulle.
Webhookeja ei ole. Tilausten muutokset ja käyttöoikeuspyyntöjen tilan haet rajapinnasta.
Kutsumäärillä on avainkohtaiset rajat, ja jokainen vastaus kertoo, paljonko rajasta on jäljellä.
Valmiit SDK-kirjastot julkaistuvat lähiaikoina. Käytät HTTP-kutsuja tai OpenAPI-kuvauksesta generoitua asiakaskirjastoa.
Kumppanit eivät ole Johkun jälleenmyyjiä. Kauppiaan sopimussuhde Johkuun on aina suora.
Aloita kumppaniohjelmasta
Tapaamisen varaat Ilkan tai Samin kalenterista kumppaniohjelman sivulla. Tutustu sillä välin dokumentaatioon.

