Korrus 01 · Tarkvara
API liidestus. Süsteemid, mis räägivad.
API liidestus ühendab teie veebilehe, äpid ja veebiteenused, millest need sõltuvad, nagu makseteenused, broneerimistööriistad, kaardid, e-post ja AI-mudelid, nii et andmed liiguvad nende vahel iseenesest. yop ehitab ja hooldab liidestusi Tallinnast koos jälgimise ja logidega. Kood, võtmed ja kontod jäävad teie nimele.
Liidestused
Mida API liidestus sisaldab?
Liidestus laseb kahel süsteemil andmeid vahetada ilma inimeseta vahepeal: makstud ost kinnitab broneeringu, registreerumine veebilehel jõuab e-posti tööriista, paki olek ilmub kliendi kontole. Töö on vähem koodis ja rohkem selle ümber olevates detailides: milline süsteem on tõeallikas, kuidas väljad vastenduvad, mis juhtub, kui üks pool on maas.
Ehitame liidestusi REST- ja GraphQL-API-dele, webhookidele ja vajadusel vanematele SOAP- või failipõhistele liidestele. Igaüks saab logimise, korduskatsed ja hoiatused, nii et ebaõnnestunud sünkroonimine märgatakse minutitega, mitte kuu lõpus.
Liidestusi ärisüsteemide sees, nagu raamatupidamine, e-arved ja turuplatside ühendused, ehitab meie sõsarettevõte pirdir.
- Maksed. Stripe, PayPal, Klarna ja pangalingid, ühendatud ostukorvide, tellimuste ja tagasimaksetega.
- Veebilehe ja äpi andmed. Kontod, vormid ja sisu jagatud teie veebilehe, äpi ja teie enda API vahel.
- Kolmandate osapoolte teenused. Kaardid, broneerimine, sõnumid, e-post ja AI API-d teie tootesse ühendatud.
- E-poed. Tooted, laoseis ja tellimused sünkroonis teie poe ja seda ümbritsevate teenuste vahel.
Mida ühendame
Kõige sagedasemad ühendused.
Maksed ja püsimaksed
Ostukorv, korduvmaksed, tagasimaksed ja makse olek sünkroonis teie veebilehe või äpiga.
E-poed
Poe tellimused, laoseis ja hinnad sünkroonis poe ümber olevate teenustega, graafiku järgi või reaalajas.
Veebi ja äpi taustasüsteem
Veebileht ja mobiiliäpp loevad ja kirjutavad samu andmeid ühe API kaudu.
Välised API-d
Kaardid, broneerimine, sõnumid, e-post ja AI-teenused lisatud teie tootesse, võtmed turvaliselt hoitud.
Webhookid ja sündmused
Kohesed uuendused teenuste vahel, kui midagi juhtub, ja korduskatsed, kui päring ebaõnnestub.
Oma API
Puhas, dokumenteeritud API teie enda tarkvarale, et partnerid ja tulevased tööriistad saaksid sellega ühenduda.
Tõrkeõppus
Kui midagi katki läheb, midagi ei kao.
Makstud tellimus liigub makseteenuselt teie poodi. Valige, mis valesti läheb, ja lugege, kuidas liidestus vastab.
Illustratsioon. Päris korduskatsete ajad ja piirangud sõltuvad iga pakkuja reeglitest.
Ostukorv · tellimus #1042
2 × kohvisegu, 250 g
38,00 € · kaardimakse
- allkirja kontroll
- uus katse
- dedup
- järjekord
- adapter
integration.logtail -f
- 09:58:00INFOworker töös · kuulab /webhooks/payment
- 09:58:00INFOmarsruudid: /orders poodi · /receipts e-posti
- 09:58:00INFOkorduskatsed: 5 korda, vahega 30 s kuni 30 min
- 09:58:01OKseisukontroll · pood 200 · e-post 200
- 09:58:01INFOjärjekord tühi · hoiatused valvevastutajale
- 10:42:07INpayment.paid #1042 · võti pay_1042
- 10:42:07OKallkiri kontrollitud · võti on uus
- 10:42:07200POST /orders/1042/paid · 86 ms
- 10:42:07202POST /receipts #1042 · 47 ms
- 10:42:07200pakkujale vastatud · kokku 140 ms
- 10:44:12INpayment.paid #1043 · võti pay_1043
- 10:44:22504POST /orders/1043/paid · 10 s vastuseta
- 10:44:52RETRYkatse 2/5 30 s pärast · 504
- 10:46:52RETRYkatse 3/5 2 min pärast
- 10:46:52200POST /orders/1043/paid · 310 ms · makstud
- 10:51:30INpayment.paid #1044 · võti pay_1044
- 10:51:30200POST /orders/1044/paid · 92 ms
- 10:51:33INpayment.paid #1044 · võti pay_1044 uuesti
- 10:51:33SKIPvõti pay_1044 juba töödeldud · teist tellimust pole
- 10:51:33200pakkujale vastatud · üks tellimus, üks kiri
- 11:03:15INpayment.paid #1045 · võti pay_1045
- 11:03:15200POST /orders/1045/paid · 88 ms
- 11:03:15503POST /receipts #1045 · e-posti teenus maas
- 11:03:15QUEUEkviitung #1045 ootel · 3 ootel · kordus iga 60 s
- 11:03:16ALERTvalvajale teatatud: e-post maas 11:01-st
- 11:20:02WARNpood saatis Sunset: 31.03.2027 API v1 kohta
- 11:20:02INFOv2 nimetab „amount“ ümber „total“-iks
- 11:21:40TESTadapter v2 testis · 48/48 läbitud
- 11:22:05200POST /v2/orders/1046/paid · 95 ms
- 11:22:05OKv2-le üle enne v1 sulgemist
Tavaline: makstud, salvestatud, kiri läinud alla sekundi
Liidestuse sõnad
Kuus sõna, mida tasub teada.
- Idempotentsus
- Tagab, et kaks korda saadetud sama päring mõjub nagu üks. See hoiab ära topelt tellimused ja topelt maksed.
- Liivakast
- Teenuse testkoopia, kus maksed ja sõnumid on võltsid, nii et kõike saab ohutult proovida.
- OAuth
- Standardne viis, kuidas üks rakendus saab piiratud ligipääsu teisele kontole, ilma selle parooli kunagi nägemata.
- Päringulimiit
- Päringute arv, mida API teatud aja jooksul vastu võtab. Liidestus paneb päringud järjekorda, et piiri sisse jääda.
- Tõeallikas
- See üks süsteem, mille väärtus võidab, kui kaks süsteemi sama välja osas erinevad.
- Webhook
- Sõnum, mille üks teenus saadab teisele kohe, kui sündmus toimub, näiteks kui makse laekub.
Võrdlus
Oma liidestus või valmis konnektor?
| Oma liidestuse võrdlus valmis konnektorrakendusega | Oma liidestusMeie valik | Valmis konnektor |
|---|---|---|
| Sobib teie andmete ja reeglitega | Jah | Oma seadete piires |
| Jälgimine ja hoiatused | Sisse ehitatud | Erineb |
| Kuutasu | Ainult majutus | Konnektori või ülesande kohta |
| Erandite käsitlemine | Nii, nagu teie otsustate | Nii, nagu tarnija otsustab |
| Sobib kõige paremini | Põhivood, suur maht, erireeglid | Lihtsad, tavapärased ühendused |
Nii see käib
Neli sammu liikuvate andmeteni.
Kaart
Kirjalik kaart igast süsteemist, väljast ja reeglist, kus on kirjas, milline süsteem hoiab põhikoopiat.
Arendus
Konnektorid ehitatud testkontode peal, koos logimise, korduskatsete ja hoiatustega.
Testimine
Päris juhtumid läbi mängitud algusest lõpuni, ka ebamugavad: duplikaadid, tagasimaksed, ajalõpud.
Käitamine
Käivitus, jälgimine ja parandus, kui tarnija oma API-t muudab.
Hind
Mis määrab liidestuse hinna.
Kaks hea API-ga süsteemi on lihtne juhtum. Need asjad lisavad tööd.
Süsteemide arv
Iga lisasüsteem toob oma väljad, piirangud, testkontod ja tõrkeviisid.
Vanad liidesed
SOAP-teenused, failivahetus ja otse andmebaasi ühendus vajavad rohkem hoolt kui kaasaegne REST API.
Reaalajas või graafikus
Kohesed webhookid vajavad järjekordi ja korduskatseid; öist sünkroonimist on lihtsam teha ja jälgida.
Ebatavalised reeglid
Osalised tagasimaksed, jagatud saadetised ja valuuta ümardamine on kohad, kuhu kulub suurem osa testimise ajast.
Andmete maht
Suur maht vajab lehekülgedeks jagamist ja tempot, kuid muudab harva disaini ennast.
Jälgimise vajadus
Logid, hoiatused ja nimeline vastutaja on alati sees; nende jaoks eraldi dashboardid on valikulised.
Pärast starti
Mis juhtub, kui API muutub?
API-d muutuvad: tarnijad avaldavad uusi versioone, kaotavad vanu välju ja muudavad oma piiranguid. Igal yopi ehitatud liidestusel on logid ja hoiatused ning me jälgime hooldatavate API-de muudatusteateid, nii et uuendused planeeritakse enne, kui vana versioon töötamast lakkab.
Hooldus võib käia fikseeritud kuuhinnaga või selle võib üle võtta teie enda meeskond meie üle antud dokumentatsiooniga.
Oma süsteemid
Nimetage tööriistad, me joonistame seosed.
Kirjutage, milliseid süsteeme kasutate ja kus inimesed andmeid nende vahel uuesti sisestavad. Vastame kahe tööpäeva jooksul ja saadame liidestuste kaardi.
Küsimused
Küsitakse liidestuste kohta.
Kui palju maksavad liidestused?
Liidestused hinnastame fikseeritud hinnaga iga etapi kohta pärast süsteemide ja andmete kaardistamist. Mahu otsustavad süsteemide arv, andmemaht ja see, kui ebatavalised on reeglid.
Kui kaua võtab liidestuse tegemine aega?
Ühendus kahe hea API-ga süsteemi vahel töötab sageli mõne nädalaga. Liidestused vanade süsteemidega, paljude reeglitega või mitme riigiga võtavad kauem.
Kas saate liidestada vanu süsteeme, millel API puudub?
Sageli jah. Kasutame ligipääsu andmebaasile, failivahetust või väikest API-kihti vana süsteemi ees, valides selle järgi, mis on stabiilne ja lubatud.
Milliseid süsteeme saate liidestada?
Liidestame veebilehti, mobiiliäppe, makseteenuseid, e-poode, broneerimis- ja sõnumitööriistu, e-posti platvorme, AI-mudeleid ja enamikku dokumenteeritud API-ga SaaS-tööriistu.
Kuidas hoiate liidestused töökindlana?
Igal liidestusel on logid, korduskatsed, hoiatused ja iga andmevälja jaoks selge vastutaja. Ebaõnnestunud sünkroonimised märgitakse minutitega, nii et need saab parandada enne, kui keegi märkab.
Kellele kuuluvad liidestuse kood ja API-võtmed?
Kood ja võtmed on teie omad. Ligipääsuandmed ja tarnijate kontod on teie nimel ja dokumenteeritud, et teine meeskond saaks jätkata.
Korrus 01 · Tarkvara
Veel korruselt: Tarkvara
Rätsepatarkvara, SaaS, äpid ja tehisintellekt, mis kuuluvad teie ettevõttele.
Tarkvara, mis on ehitatud teie ettevõtte praeguse tööviisi järgi.
Püsitellimusega tooted koos kontode, pakettide ja arveldusega.
Väikseim päris toode, mida maksvad kasutajad saavad proovida.
iOS- ja Android-äpid, mis jäävad telefoni avaekraanile.
Numbrid ja vaated, mille teie meeskond igal hommikul avab.
Turustaja töölaud, sponsoripuu ja komisjonitasud teie plaani järgi.
Tehisintellekt ja automatiseerimine tööriistades, mida juba kasutate.