API

Een API (Application Programming Interface) is een set van definities, protocollen en hulpmiddelen voor het bouwen van software. Anders gezegd, het is een set duidelijk gedefinieerde communicatiemiddelen tussen verschillende programma’s. Hierdoor kunnen softwareprogramma’s met elkaar communiceren.

Simpel gezegd is een API de manier van communiceren tussen twee entiteiten. Neem als voorbeeld een nieuwsapp op uw telefoon. Zodra u deze app opent, ziet u het laatste nieuws verschijnen. Dit betekent echter niet dat het laatste nieuws ook echt op uw telefoon staat. Op het moment dat u de app opent, doet deze een oproep naar de nieuwssite. De nieuwssite herkent deze oproep en stuurt het laatste nieuws door middel van een code terug naar uw telefoon. 

De API leest de code die wordt teruggezonden en zet deze om naar een nieuwsbericht met tekst, foto’s en linkjes en projecteert deze in uw app. U kunt vervolgens alle nieuwsberichten lezen. De API zorgt ervoor dat al deze handelingen realtime uitgevoerd worden. Zo werkt iedere API; het fungeert als een zender, ontvanger en vertaler van berichten tussen verschillende databases.

REST staat voor REpresentation State Transfer en is een manier om webservices te creëren op basis van eenvoudige en bestaande bouwstenen. De meeste moderne programmeertalen kunnen worden aangesloten op REST, waardoor een REST API relatief makkelijk in te bouwen applicatie is. 

Als gevolg van het gebruik van bestaande bouwstenen, kunnen REST API’s ook in verschillende fasen worden geïmplementeerd of later eenvoudig naar nieuwe versies worden gekloond.

JSON staat voor JavaScript Object Notation en is een op JavaScript gebaseerde manier om gegevens weer te geven en op te slaan. Daarnaast wordt data verzonden in een voor mensen leesbare tekst.

RAML staat voor RESTful API Modeling Language en is een eenvoudige en beknopte manier om REST API’s te beschrijven. RAML heeft tot doel het huidige API-ecosysteem te helpen door directe problemen op te lossen en steeds betere API-patronen aan te moedigen. RAML is gebouwd op algemeen gebruikte standaarden (zoals YAML en JSON).

• JSON / REST verzendt minder gegevens simultaan, wat resulteert in betere prestaties en hogere snelheid.
• De gegevensstructuur bevat referenties voor het beter begrijpen van gegevensverbindingen (HATEOAS).
• JSON / REST lijkt meer op een browser. Het is een generieke cliënt die weet hoe een protocol en gestandaardiseerde methoden moeten worden gebruikt.
• JSON / REST Datamodellen zijn uit te breiden, dus gegevens kunnen nu of in de toekomst worden toegevoegd, zonder dat dit gevolgen heeft voor u als klant.

Graydon kende voorheen meerdere API’s, die ook wel GTS genoemd werden. Bij GraydonCreditsafe is alles onder één API ondergebracht: Creditsafe Connect API. Er zijn verschillende verbeteringen aangebracht in de Connect API ten opzichte van GTS:

• GTS is alleen beschikbaar in het XML format, terwijl de Connect API vooral in JSON format is. JSON is makkelijker te lezen dan XML en daardoor eenvoudiger te analyseren en sneller gebruiksklaar. Daarnaast geeft JSON nog wel de mogelijkheid om data in XML formaat te exporteren, indien dit wenselijk is.
• GTS was gebouwd in het SOAP model, terwijl Connect API is gebouwd volgens het REST model.
• GTS wordt niet meer geüpdatet, terwijl Connect API wordt ontwikkeld op een AGILE wijze. 

De API van GraydonCreditsafe heet Connect API. Connect is een REST API die toegang biedt tot onze internationale database met bedrijfs- en kredietinformatie over 430 miljoen bedrijven. Hiermee kunt u de gewenste data van GraydonCreditsafe in uw eigen systeem integreren.

Met de Connect API.:

• Heeft u controle over uw stamgegevens.
• Heeft u toegang tot actuele bedrijfs-, krediet- en directeurinformatie gebruiken, waardoor uw onboarding- en kwalificatieprocessen worden verbeterd.
• Ontvangt u waarschuwingen wanneer het Kredietinformatierapport van uw klanten en leveranciers verandert.