Skift til midlertidigt FBI-API inden for tre måneder
Da vi har rettet nogle skemafejl i FBI-API’et, har vi lavet et midlertidigt API, som I skal skifte til inden for tre måneder.
Vi er blevet opmærksomme på en inkonsekvent brug af skemadefinitioner i FBI-API’et. Problemet skyldes primært et sammenfald i navngivning, der opstår ved konvertering, som ikke er case-sensitiv.
Vi har derfor gennemgået FBI-API’et og besluttet ikke blot at rette de berørte felter, men også at indføre en ny struktur, der skal forhindre lignende skemafejl fremadrettet.
Det betyder, at I inden for de næste tre måneder skal skifte til et midlertidigt API.
Midlertidigt FBI-API kan tages i brug med det samme
Ifølge vores normale procedure skal de ændrede felter markeres som ‘deprecated’ og varsles med tre måneder. Det vil dog betyde, at de problematiske feltnavne først vil blive fjernet efter minimum tre måneder, hvilket ikke er hensigtsmæssigt.
Vi har derfor besluttet, rent undtagelsesvist, at indføre et midlertidigt API, så I med det samme kan skifte til dette og undgå de problematiske felt-navngivninger.
De specifikke ændringer er
- Fjernelse af ubrugte scalar-typer
- Konsistent brug af PascalCase for alle typer
- Brug af UPPERCASE for alle enum-værdifelter
- Unikke feltnavne uanset case
- Alle input-typer har nu suffixet ‘Input’
- Alle scalar-typer har nu suffixet ‘Scalar’
- Alle union-typer har nu suffixet ‘Union’
- Alle interface-typer har nu suffixet ‘Interface’
Vi har fjernet tidligere deprecaterede felter
Udover at indføre den nye struktur har vi fjernet alle tidligere deprecaterede felter, der har været varslet i minimum tre måneder.
Med et token kan I her se præcis, hvilke felter der er ændret.
Bemærk, at felter, der er overstreget, kun anvendes internt og derfor ikke er relevante for jer. For de øvrige felter vises det, om de er fjernet eller har skiftet navn.
For de fleste vil det være en copy-paste opgave at implementere ændringerne, men vær opmærksom på tidligere deprecaterede felter, hvis disse ikke allerede er blevet opdateret.
Skift til det midlertidige API
Det er nødvendigt, at alle brugere af FBI-API’et skifter til det midlertidige API inden for de næste tre måneder.
Det nuværende FBI-API vil blive opdateret til at matche det midlertidige API den 1. november 2024.
Herefter vil det midlertidige API softlinke til det almindelige FBI-API, hvilket giver jer god tid til at skifte tilbage.
Vi beklager de gener, dette måtte medføre, og vi håber, at de tiltag, vi har indført, sikrer, at lignende situationer ikke opstår fremover.
Hvis I har spørgsmål, er I meget velkomne til at kontakte kundeservice.