Platformok / 01
Van REST API. Integrációra van szükség.
A dokumentáció rendelkezésre áll, a tesztkérés működik. A napi működésben mégis hiányoznak adatok vagy duplikált rekordok keletkeznek. A DataSource a konkrét üzleti folyamathoz kapcsolja REST-API-ját, és a válasz elmaradásával is számol.
Kiinduló helyzet
A sikeres request csak a kezdet.
Egy portálnak ügyfeleket kell átvennie egy ERP-ből. A rendszerek eltérő ID-kat és kötelező mezőket használnak. Az ERP lapozva adja vissza az eredményeket, a portál korlátozza az írási hozzáférést. A kézi export elfedi ezeket a különbségeket, de nem oldja meg őket.
A megvalósítás előtt ellenőrizzük a támogatott API-verziót, az adatmennyiséget, a frissítési igényt és a célrendszeri kontraktust. Az OpenAPI-dokumentáció segít; a valós, anonimizált válaszok és hibaüzenetek ugyanolyan fontosak.
A DataSource feladatai
Adatkontraktus, hozzáférés és újraindítás.
Adatkontraktus
A forrás- és célmezők, azonosítók, adattípusok és kötelező értékek egyeztetése. A hiányzó értékekre és sémamódosításokra meghatározott szabályok vonatkoznak.
Hozzáférés és adatátvitel
A hitelesítés, jogosultsági kör és tokenmegújítás megvalósítása az API előírásai szerint. A lapozás, időkorlátok és függő objektumok sorrendjének figyelembevétele.
Újraindítás
Az átviteli állapot és külső ID-k nyilvántartása úgy, hogy a megszakadt futások folytathatók legyenek. Bizonytalan írási választ először ellenőrizni kell, mielőtt újabb írás történik.
Műszaki forgatókönyv / szemléltető példa
Ügyfelek egyeztetése duplikált létrehozás nélkül.
A példa egy javasolt célrendszeri kontraktust mutat be. A külső ügyfél-ID az üzleti kulcs. Az upsert és idempotenciamechanizmusokat a cél-API-nak kell támogatnia, vagy az integrációban kell megvalósítani.
Példaadatok és javasolt szabályok. A konkrét interfészeket és üzleti szabályokat a projektjéhez ellenőrizzük.
PUT /customers/004218
Content-Type: application/json
{
"externalId": "004218",
"name": "Beispiel GmbH",
"countryCode": "AT"
}Hibakezelés, biztonság és üzemeltetés
HTTP-hibák megfelelő kezelése.
Rate limitek
HTTP 429 esetén az API előírásainak és szükség esetén a Retry-After értékének figyelembevétele. Korlátozott számú ismétlés tervezése backoff-fal; a tartós validációs hibák javítást igényelnek.
Módosítási konfliktusok
ETag vagy verziómezők használata, amennyiben támogatottak. Egy időközben módosított rekordot nem szabad régi állapottal felülírni.
Üzemeltetés
Korrelációs ID-k, számlálók és hibakategóriák dokumentálása. Tokenek és teljes személyes adatokat tartalmazó payloadok nem kerülhetnek általános üzemeltetési naplókba.
Szakmai kérdések
Részletek, amelyek a megvalósítás előtt számítanak.
HTTP · REST · OAuth · API Keys · Pagination · Retry
Minden API támogatja az upsertet?
Nem. Egyes API-k csak külön create és update végpontokat biztosítanak. Ilyenkor az integrációnak megbízható hozzárendelésre és a bizonytalan eredmények kezelésére szolgáló eljárásra van szüksége.
Szükségünk van valós idejű működésre?
Ez az üzleti folyamattól függ. A polling elegendő lehet; a webhook akkor hasznos, ha a forrás megbízhatóan jelzi a változásokat. Az egyeztetés továbbra is hasznos az elmulasztott eseményekhez.
Mi történik egy új API-verziónál?
Tesztkörnyezetben ellenőrizzük a kontraktusokat és a reprezentatív hibaeseteket. A kivezetési határidőket, átállást és visszaállítás módját az éles módosítás előtt egyeztetjük.
A műszaki egyeztetéshez
A konkrét folyamatból indulunk ki.
Kérjük, készítse elő az API-dokumentációt, verziót, anonimizált példákat, a kívánt adatirányt és frissítési igényt. Hasznosak az ismert korlátok és annak tisztázása, melyik rendszer mely mezőkért felelős.
Az első beszélgetésen tisztázzuk az elérhető hozzáféréseket, az adatfelelősséget és egy körülhatárolt első adatfolyamot. Ezután egyeztetjük a terjedelmet, felelősségi köröket és feltételeket.
Projektmegkeresés
Mely API-knak kell együttműködniük?
Röviden ismertesse a jelenlegi folyamatot és a kívánt eredményt.
Kapcsolódó feladatok
A következő integráció összefüggései.
Webhookok megbízható feldolgozása
Esemény érkezik, amelynek a következő rendszerben műveletet kell kiváltania. Többszörös kézbesítés, késés vagy kiesett cél-API esetén ebből üzemeltetési folyamat lesz. Egyértelmű eseményekkel és ellenőrizhető hatásokkal fejlesztjük ezt a működést.
JSON / XML adatátalakítás
Az adatok műszakilag olvashatók, mégis elutasítják őket. A mezőnevek, típusok vagy struktúrák nem illenek a célalkalmazáshoz. Olyan követhető leképezést fejlesztünk, amely az üres értékeket, különleges eseteket és forrásformátum-változásokat is kezeli.
Adatok szinkronizálása rendszerek között
Az ügyfelet a CRM-ben és az ERP-ben is módosítják. Melyik állapot érvényes? A szinkronizációt üzleti felelősségekre és stabil identitásokra építjük, hogy a rendszeres átvitel ne okozzon rejtett adatkonfliktusokat.
Műszaki hivatkozások
Hivatalos dokumentáció, ellenőrizve: 2026. október 6. Az alkalmazhatóság az adott telepítéstől és verziótól függ.