API Koppeling Azure DevOps | Boards, Pipelines & Repos

Azure DevOps is het DevOps-platform van Microsoft dat boards (werk bijhouden), repos (code beheren), pipelines (CI/CD), test plans en artifacts (pakketbeheer) bundelt in een geïntegreerde omgeving. Veel development teams in Nederland gebruiken het als centraal systeem voor hun softwareontwikkeling, vooral wanneer de organisatie al investeert in het Microsoft-ecosysteem met Azure, Entra ID en Microsoft 365.

De REST API van Azure DevOps dekt vrijwel het volledige platform. U kunt work items aanmaken, wijzigen en opvragen; builds triggeren en bewaken; pull requests beheren; en release gates definiëren die bepalen of een deployment door mag gaan. Service hooks maken het mogelijk om events vanuit Azure DevOps door te sturen naar externe systemen, bijvoorbeeld wanneer een build slaagt, een work item van status verandert of een pull request wordt goedgekeurd.

Een bijzonderheid van Azure DevOps is de ondersteuning voor WIQL (Work Item Query Language), een SQL-achtige taal waarmee u geavanceerde queries kunt uitvoeren op work items. Dit maakt het mogelijk om vanuit uw eigen software complexe rapportages te genereren of slimme automatiseringen te bouwen die reageren op specifieke combinaties van status, toewijzing en prioriteit.

Organisaties gebruiken Azure DevOps niet in isolatie. Salesteams werken in een CRM, supportteams in een ticketsysteem, management in dashboards. De kracht van een API-koppeling zit in het verbinden van die werelden: sales maakt een deal, en automatisch ontstaat een epic in Azure DevOps met de juiste structuur. Support meldt een bug, en die belandt direct als work item bij het development team met alle relevante context.

Development teams functioneren het best wanneer zij zich kunnen concentreren op technisch werk zonder te worden belast met administratieve taken. In de praktijk besteden engineers tijd aan het handmatig aanmaken van work items, het kopiëren van informatie tussen systemen en het bijwerken van statussen in tools die niet zijn ontworpen voor software development. Dat kost niet alleen productiviteit, het vergroot ook het risico op onvolledige of verouderde informatie.

Een koppeling met Azure DevOps elimineert dat handwerk. Wanneer een klant een supportverzoek indient, kan uw systeem automatisch een bug of user story aanmaken in het juiste Azure DevOps-project, compleet met beschrijving, prioriteit en links naar het originele ticket. Wanneer een salesdeal wordt gesloten, kan een epic worden aangemaakt met standaard taken die het development team nodig heeft om aan de slag te gaan. Wanneer een release wordt uitgerold, kunnen release notes automatisch worden gepubliceerd naar een klantportaal.

Daarnaast biedt de koppeling waarde voor governance. Door work items programmatisch te koppelen aan business-objecten in uw eigen systemen, ontstaat traceerbaarheid van klantverzoek tot deployment. Dat is niet alleen nuttig voor interne audits, maar ook voor klanten die willen weten wanneer hun verzoek is opgelost en uitgerold.

Voor organisaties met meerdere teams of projecten biedt de API ook mogelijkheden voor cross-project rapportages. In plaats van handmatig dashboards bij te houden, kunt u automatisch inzicht geven in doorlooptijden, capaciteit en voortgang over alle projecten heen.

Authenticatie bij Azure DevOps verloopt via Personal Access Tokens (PATs) of OAuth 2.0 via Azure AD (Entra ID). PATs zijn eenvoudig op te zetten maar hebben beperkingen: ze zijn gekoppeld aan een individueel gebruikersaccount en verlopen na maximaal een jaar. Voor productie-integraties adviseren we OAuth met een geregistreerde applicatie in Entra ID, wat fijnmaziger rechten toestaat en niet afhankelijk is van een persoonlijk account.

De REST API is geversioned via de api-version query parameter. Dat betekent dat u expliciet kunt kiezen welke versie van een endpoint u aanroept. We pinnen onze integratie op een specifieke versie en monitoren deprecatie-meldingen van Microsoft, zodat migraties ruim op tijd worden gepland. Het is niet ongebruikelijk dat Microsoft nieuwe velden toevoegt aan responses, wat backward-compatible is, maar af en toe worden endpoints ook uitgefaseerd.

Voor het opvragen van work items gebruiken we WIQL (Work Item Query Language), waarmee complexe queries mogelijk zijn op velden als status, toegewezen persoon, iteratiepad en aangepaste velden. WIQL retourneert ID's, waarna we de details per item ophalen. Bij grote resultsets batchen we de detailrequests om binnen rate limits te blijven.

Service hooks zijn het event-systeem van Azure DevOps. U configureert subscripties die events zoals work item updates, build completions of pull request status changes doorsturen naar een webhook endpoint. Elk service hook verzoek bevat een payload met de relevante data en een eventheader. We valideren binnenkomende verzoeken op basis van een shared secret dat tijdens de configuratie wordt ingesteld.

Voor multi-organisatie setups, waarbij meerdere Azure DevOps-organisaties moeten worden aangesproken, scheiden we credentials en projectconfiguratie per organisatie. Dit voorkomt dat een configuratiefout in organisatie A invloed heeft op organisatie B.

Authenticatie en autorisatie vereisen bijzondere aandacht bij Azure DevOps-integraties. PATs zijn gebonden aan een individueel account en geven potentieel brede toegang als de scopes niet zorgvuldig worden ingesteld. We beperken PAT-scopes tot het minimum en adviseren waar mogelijk over te stappen op OAuth via Entra ID, dat meer granulariteit en audit logging biedt.

Pipeline variable groups bevatten vaak gevoelige waarden zoals API keys, database connection strings of deployment credentials. Wij slaan deze nooit in plain text op. In plaats daarvan gebruiken we Azure Key Vault of de ingebouwde secrets functionaliteit van Azure Pipelines, waarbij waarden versleuteld worden opgeslagen en pas tijdens runtime beschikbaar zijn.

Service hook endpoints moeten worden beveiligd tegen ongeautoriseerde toegang. We configureren een shared secret bij elke subscriptie en valideren elk binnenkomend verzoek. Endpoints zijn alleen bereikbaar via HTTPS en worden afgeschermd met IP-whitelisting waar de infrastructuur dat toestaat.

API-versioning is een terugkerende uitdaging. Azure DevOps evolueert actief en Microsoft voegt regelmatig nieuwe endpoints en velden toe. Hoewel de meeste wijzigingen backward-compatible zijn, worden oudere versies uiteindelijk uitgefaseerd. Wij pinnen integraties op een specifieke API-versie en monitoren de deprecatie-agenda, zodat migraties worden ingepland zonder haast of downtime.

Cross-project queries vereisen organisatieniveau rechten, die niet altijd standaard beschikbaar zijn. Sommige organisaties beperken uit beveiligingsoverwegingen de toegang tot specifieke projecten. We brengen deze beperkingen vroeg in kaart en ontwerpen de integratie zodanig dat ze binnen de bestaande governance past.

Grote attachments bij work items vormen een derde aandachtspunt. Azure DevOps beperkt de grootte van bijlagen en de API gedraagt zich anders bij bestanden boven bepaalde drempels. We bouwen upload-logica die bestanden chunked verwerkt en foutafhandeling bevat voor scenarios waarin de limiet wordt bereikt.

Na de initiële oplevering monitoren we service hook delivery rates, API-foutpercentages en de status van Azure DevOps Services. Wanneer Microsoft een nieuwe API-versie releaseert of een bestaande depreceert, plannen we de migratie in een regulier onderhoudsvenster.

PATs verlopen na maximaal een jaar en moeten tijdig worden vernieuwd. We configureren herinneringen die ruim voor de verloopdatum worden verstuurd, zodat de integratie niet plotseling stopt met functioneren.

De investering in een Azure DevOps-koppeling hangt samen met het aantal geautomatiseerde flows en de complexiteit van uw projectstructuur. Een eenvoudige koppeling die work items aanmaakt vanuit een extern systeem kan in twee tot drie weken live staan. Een uitgebreide integratie met WIQL-rapportages, pipeline triggers en release gates vergt meer engineeringtijd en testwerk.

Azure DevOps brengt zelf geen API-kosten in rekening; het gebruik is inbegrepen in uw Azure DevOps-licentie. Wel gelden er rate limits die bij intensief gebruik relevant worden. We dimensioneren de integratie op basis van uw verwachte volumes.

Bij MG Software ontvangt u een gedetailleerde offerte na een scopingsworkshop. We werken in sprints met een vast budget per sprint, zodat u tussentijds kunt bijsturen op prioriteiten.