API protocol

Er zijn verschillende soorten API-protocollen, waaronder bv GraphQL, REST, SOAP en EDI. REST (Representational State Transfer) en SOAP (Simple Object Access Protocol) zijn beide stijlen van webservices die gebruik maken van HTTP voor communicatie. Waarbij SOAP vooral werkt met POST en REST gebruik maakt van GET, POST, PUT en DELETE.

REST en GraphQL zijn eenvoudig te gebruiken en goed geschikt voor webapplicaties vanwege het gebruik van web technologieën. Waarbij GraphQL veel vrijheid aan de client kant geeft, omdat je net als bij een database kunt queryen op de endpoints. SOAP API’s gebruiken XML voor berichtenuitwisseling en bieden uitgebreide beveiligingsfuncties, wat ze geschikt maakt voor complexe en veilige transacties, zoals in financiële diensten. EDI (Electronic Data Interchange) is een standaard voor elektronische uitwisseling van bedrijfsdocumenten, zoals facturen en orderbevestigingen. EDI API’s worden vaak gebruikt in zakelijke omgevingen om de efficiëntie van bedrijfsprocessen te verbeteren door handmatige invoer te verminderen en gegevensuitwisseling te automatiseren.

Kortom, een API-protocol beschrijft hoe een API opgezet met worden en gebruikt gebruikt taal onafhangkelijke berichten, waarmee verschillende softwareprogramma’s om effectief met elkaar kunnen communiceren. Begrijpen hoe je met API-protocollen werkt, is een fundamentele vaardigheid voor elke programmeur.

Kort (niet volledig) overzicht

Protocol	Message	connection	bron
EDI	CSV	TCP (proprietary of standaarden)	https://www.edibasics.com/
SOAP	XML	HTTP (POST) of andere standaarden	https://www.w3schools.com/xml/xml_soap.asp
REST	JSON	HTTP (GET, POST, PUT, DELETE, PATCH)	https://restfulapi.net/
GraphQL	JSON	HTTP (GET, POST)	https://graphql.org/