Kerros 01 · Ohjelmistot
Integraatiot ja rajapinnat. Järjestelmät puhuvat.
Integraatiot liittävät verkkosivusi, sovelluksesi ja niiden käyttämät verkkopalvelut, kuten maksupalvelut, ajanvarauksen, kartat, sähköpostin ja tekoälymallit, toisiinsa rajapintojen kautta, jolloin data liikkuu niiden välillä itsestään. yop rakentaa ja ylläpitää API-integraatioita Tallinnasta valvonnan ja lokien kanssa, ja koodi, avaimet ja tilit pysyvät sinun nimissäsi.
Integraatiot
Mitä API-integraatio sisältää?
Integraatio antaa kahden järjestelmän vaihtaa tietoja ilman ihmistä välissä: maksettu ostos vahvistaa varauksen, sivuston rekisteröityminen siirtyy sähköpostityökaluun, paketin tila näkyy asiakkaan tilillä. Työ koskee vähemmän koodia kuin sen ympärillä olevia yksityiskohtia: mikä järjestelmä on totuuden lähde, miten kentät vastaavat toisiaan ja mitä tapahtuu, kun toinen puoli ei vastaa.
Rakennamme integraatiot REST- ja GraphQL-rajapintoihin, webhookeihin ja tarvittaessa vanhoihin SOAP- tai tiedostoliittymiin. Jokainen saa lokit, uudelleenyritykset ja hälytykset, joten katkennut synkronointi huomataan minuuteissa eikä kuun lopussa.
Liiketoimintajärjestelmien sisäiset integraatiot, kuten kirjanpito, verkkolaskutus ja markkinapaikkayhteydet, rakentaa sisaryrityksemme pirdir.
- Maksut. Stripe, PayPal, Klarna ja kotimaiset maksupalvelut kassaan, kestotilauksiin ja hyvityksiin.
- Sivuston ja apin data. Tilit, lomakkeet ja sisältö jaettuna sivustosi, sovelluksesi ja oman rajapintasi kesken.
- Ulkoiset palvelut. Kartat, ajanvaraus, viestit, sähköposti ja tekoäly osaksi tuotettasi.
- Verkkokaupat. Tuotteet, varasto ja tilaukset pysyvät tahdissa kauppasi ja sitä ympäröivien palvelujen välillä.
Mitä kytkemme
Yleisimmät yhteytemme.
Maksut ja kestotilaukset
Kassa, toistuva laskutus, hyvitykset ja maksun tila pysyvät tahdissa sivustosi tai sovelluksesi kanssa.
Verkkokaupat
Kaupan tilaukset, varasto ja hinnat synkronoituna ympäröivien palvelujen kanssa aikataululla tai reaaliajassa.
Yhteinen backend
Verkkosivusi ja mobiilisovelluksesi lukevat ja kirjoittavat samaa dataa yhden rajapinnan kautta.
Ulkoiset rajapinnat
Kartat, ajanvaraus, viestintä, sähköposti ja tekoälypalvelut lisättynä tuotteeseesi, avaimet turvassa.
Webhookit ja tapahtumat
Välittömät päivitykset palvelujen välillä, kun jotain tapahtuu, ja uusi yritys, jos kutsu epäonnistuu.
Oma rajapinta
Selkeä, dokumentoitu rajapinta ohjelmistollesi, jotta kumppanit ja tulevat työkalut voivat liittyä siihen.
Häiriöharjoitus
Kun jokin hajoaa, mitään ei katoa.
Maksettu tilaus kulkee maksupalvelusta kauppaasi. Valitse, mikä menee pieleen, ja katso, miten integraatio vastaa.
Havainnollistus. Oikeat ajat ja rajat riippuvat kunkin palvelun säännöistä.
Kassa · tilaus #1042
2 × talon kahvi, 250 g
38,00 € · kortilla
- allekirjoitus
- uusinta
- tuplat pois
- jono
- adapteri
integration.logtail -f
- 09:58:00INFOworker käynnissä · kuuntelee /webhooks/payment
- 09:58:00INFOreitit: /orders kauppaan · /receipts postiin
- 09:58:00INFOuusinnat: 5 yritystä, välit 30 s:sta 30 minuuttiin
- 09:58:01OKterveystarkistus · kauppa 200 · posti 200
- 09:58:01INFOjono tyhjä · hälytykset päivystäjälle
- 10:42:07INpayment.paid #1042 · avain pay_1042
- 10:42:07OKallekirjoitus ok · avain on uusi
- 10:42:07200POST /orders/1042/paid · 86 ms
- 10:42:07202POST /receipts #1042 · 47 ms
- 10:42:07200vastaus palvelulle · yht. 140 ms
- 10:44:12INpayment.paid #1043 · avain pay_1043
- 10:44:22504POST /orders/1043/paid · ei vastausta 10 s:ssa
- 10:44:52RETRYyritys 2/5 30 s:n jälkeen · 504
- 10:46:52RETRYyritys 3/5 2 min:n jälkeen
- 10:46:52200POST /orders/1043/paid · 310 ms · maksettu
- 10:51:30INpayment.paid #1044 · avain pay_1044
- 10:51:30200POST /orders/1044/paid · 92 ms
- 10:51:33INpayment.paid #1044 · avain pay_1044 uudelleen
- 10:51:33SKIPavain pay_1044 jo käsitelty · ei toista tilausta
- 10:51:33200vastaus palvelulle · yksi tilaus, yksi viesti
- 11:03:15INpayment.paid #1045 · avain pay_1045
- 11:03:15200POST /orders/1045/paid · 88 ms
- 11:03:15503POST /receipts #1045 · postipalvelu nurin
- 11:03:15QUEUEkuitti #1045 pidossa · 3 jonossa · uusinta 60 s välein
- 11:03:16ALERTpäivystäjä tietää: posti nurin 11:01 alkaen
- 11:20:02WARNkauppa ilmoitti Sunset: 31.3.2027 API v1:lle
- 11:20:02INFOv2: ”amount” on nyt ”total”
- 11:21:40TESTadapteri v2 testissä · 48/48 läpi
- 11:22:05200POST /v2/orders/1046/paid · 95 ms
- 11:22:05OKsiirrytty v2:een ennen v1:n poistoa
Normaali: maksettu, kirjattu, viesti alle sekunnissa
Sanasto
Kuusi termiä tiiviisti.
- Idempotenssi
- Sama pyyntö kahdesti lähetettynä vaikuttaa vain kerran. Se estää tuplatilaukset ja tuplaveloitukset.
- OAuth
- Vakiotapa antaa sovellukselle rajattu pääsy toiseen tiliin ilman, että se koskaan näkee salasanaa.
- Pyyntöraja
- Kutsujen määrä, jonka rajapinta hyväksyy tietyssä ajassa. Integraatio jonottaa ja tahdittaa kutsunsa pysyäkseen sen alla.
- Testiympäristö
- Palvelun testikopio, jossa maksut ja viestit ovat leikkiä, joten kaiken voi kokeilla turvallisesti.
- Totuuden lähde
- Se järjestelmä, jonka arvo voittaa, kun kaksi järjestelmää on eri mieltä samasta kentästä.
- Webhook
- Viesti, jonka palvelu lähettää toiselle heti tapahtuman jälkeen, esimerkiksi kun maksu menee läpi.
Vertailu
Oma integraatio vai valmis liitin?
| Räätälöity API-integraatio verrattuna valmiiseen liitinsovellukseen | Räätälöity integraatioSuosituksemme | Valmis liitin |
|---|---|---|
| Sopii dataasi ja sääntöihisi | Kyllä | Asetustensa rajoissa |
| Valvonta ja hälytykset | Sisäänrakennettu | Vaihtelee |
| Kuukausimaksu | Vain palvelin | Per liitin tai tehtävä |
| Poikkeusten käsittely | Niin kuin sinä päätät | Niin kuin toimittaja päättää |
| Sopii parhaiten | Ydinprosessit, suuret määrät, erityissäännöt | Yksinkertaiset vakioyhteydet |
Näin se etenee
Neljä vaihetta kulkevaan dataan.
Kartta
Kirjallinen kartta jokaisesta järjestelmästä, kentästä ja säännöstä: mikä järjestelmä pitää pääkopiota.
Toteutus
Liittimet testitilejä vasten, lokien, uudelleenyritysten ja hälytysten kanssa.
Testaus
Oikeat tapaukset ajetaan alusta loppuun, myös hankalat: tuplat, hyvitykset ja aikakatkaisut.
Ylläpito
Käyttöönotto, valvonta ja korjaus, kun toimittaja muuttaa rajapintaansa.
Hinta
Mikä ratkaisee integraation hinnan.
Kaksi järjestelmää hyvillä rajapinnoilla on helppo tapaus. Nämä asiat lisäävät työtä.
Järjestelmien määrä
Jokainen lisäjärjestelmä tuo omat kenttänsä, rajansa, testitilinsä ja vikatilanteensa.
Vanhat liittymät
SOAP-palvelut, tiedostosiirrot ja tietokantayhteydet vaativat enemmän kuin moderni REST-rajapinta.
Reaaliaika vai ajastus
Välittömät webhookit tarvitsevat jonon ja uudelleenyritykset. Yöajo on helpompi rakentaa ja valvoa.
Erikoissäännöt
Osahyvitykset, jaetut toimitukset ja valuuttojen pyöristys vievät suurimman osan testausajasta.
Datan määrä
Suuri määrä vaatii sivutusta ja tahdistusta, mutta muuttaa harvoin itse suunnittelua.
Valvonnan tarve
Lokit, hälytykset ja nimetty vastuuhenkilö sisältyvät aina. Kojelaudat niille ovat valinnaisia.
Ylläpito
Mitä tapahtuu, kun rajapinta muuttuu?
Rajapinnat muuttuvat: toimittajat julkaisevat uusia versioita, poistavat kenttiä ja muuttavat rajoja. Jokaisessa yop-tiimin integraatiossa on lokit ja hälytykset, ja seuraamme ylläpitämiemme rajapintojen muutostiedotteita, joten päivitys tehdään ennen kuin vanha versio lakkaa toimimasta.
Ylläpidon voi hoitaa kiinteällä kuukausihinnalla, tai oma tiimisi voi ottaa sen hoitaakseen luovuttamamme dokumentaation avulla.
Järjestelmäsi
Listaa työkalusi, piirrämme yhteydet.
Kerro, mitä järjestelmiä käytät ja missä tietoja näppäillään käsin järjestelmästä toiseen. Vastaamme kahden työpäivän kuluessa, ja vastaus sisältää integraatiokartan.
Kysymykset
Kysyttyä integraatioista.
Mitä API-integraatio tekee?
API-integraatio liittää yrityksen erilliset ohjelmistot toisiinsa niiden rajapintojen kautta, jolloin tiedot kulkevat järjestelmästä toiseen ilman käsin kopiointia. yop kartoittaa datan, rakentaa yhteydet, valvoo niitä ja päivittää ne, kun rajapinnat muuttuvat.
Paljonko integraatiot maksavat?
Integraatiot hinnoitellaan kiinteällä hinnalla vaihe kerrallaan, kun järjestelmät ja data on kartoitettu. Järjestelmien määrä, datan määrä ja sääntöjen erikoisuus ratkaisevat laajuuden.
Kuinka kauan integraation rakentaminen kestää?
Kahden järjestelmän yhteys hyvillä rajapinnoilla on usein käytössä muutamassa viikossa. Vanhat järjestelmät, monet säännöt tai useat maat pidentävät työtä.
Voiko vanhan järjestelmän integroida ilman rajapintaa?
Usein voi. Käytämme tietokantayhteyttä, tiedostosiirtoa tai pientä rajapintakerrosta vanhan järjestelmän edessä sen mukaan, mikä on vakaata ja sallittua.
Mitä järjestelmiä voi integroida?
Verkkosivuja, mobiilisovelluksia, maksupalveluja, verkkokauppoja, ajanvaraus- ja viestintätyökaluja, sähköpostia, tekoälymalleja ja useimpia SaaS-palveluja, joilla on dokumentoitu rajapinta.
Miten integraatiot pysyvät luotettavina?
Jokaisessa integraatiossa on lokit, uudelleenyritykset, hälytykset ja selvä vastuuhenkilö jokaiselle kentälle. Katkos näkyy minuuteissa, joten se korjataan ennen kuin kukaan huomaa.
Kenelle integraation koodi ja API-avaimet kuuluvat?
Sinulle. Koodi, tunnukset ja palvelutilit avataan sinun nimiisi ja dokumentoidaan, joten toinen tiimi voisi jatkaa työtä.
Kerros 01 · Ohjelmistot
Lisää kerroksesta: Ohjelmistot
Räätälöidyt ohjelmistot, SaaS, sovellukset ja tekoäly, yrityksesi omistuksessa.
Ohjelmisto, joka tehdään yrityksesi tavan toimia mukaan.
Tilaustuotteet tileineen, paketteineen ja laskutuksineen.
Pienin oikea tuote, jota maksavat käyttäjät voivat kokeilla.
iOS- ja Android-sovellukset, jotka pysyvät kotinäytöllä.
Luvut ja näkymät, jotka tiimisi avaa joka aamu.
Jakelijaportaali, verkostopuu ja palkkiot oman mallisi mukaan.
Tekoäly ja automaatio työkaluihin, joita jo käytät.