Menu

Samenvatting van de GitLab API

Automatiseer je volledige software-delivery lifecycle met de GitLab API: van project-bootstrap tot pipeline-uitvoering en release-publicatie. De REST API dekt 1.122 endpoints af, GraphQL biedt flexibele queries en webhooks pushen events realtime naar je systemen.
  • Projecten en groepen: Maak projecten en sub-groepen aan, beheer members, custom attributes en project access tokens.
  • Repositories en branches: Lees commits en tags, bescherm branches, beheer deploy keys, mirrors en submodules.
  • Merge requests: Open, merge en sluit merge requests, configureer approvals en koppel pipelines aan je CI-status.
  • Pipelines en runners: Trigger pipelines, beheer scheduled jobs, runners, variabelen, artifacts en resource groups.
  • Packages en container registry: Beheer npm-, Maven-, PyPI-, Composer-, NuGet- en Helm-pakketten en publiceer containers.
  • Issues en webhooks: Synchroniseer issues en alerts, configureer integraties met Jira en Slack en stuur events naar je dashboard.
API Quick Facts REST, GraphQL
  • Authenticatie OAuth2, API Key, Bearer Token
  • Methods GET (495)PUT (260)POST (238)DELETE (121)PATCH (8)
  • Rate limits Standaard op GitLab.com: 2.000 authenticated requests/minuut per gebruiker en 500 unauthenticated requests/minuut per IP. Aparte limieten voor pipeline creation (25/minuut), package downloads en Search API. Self-managed instances configureren limieten zelf.
  • Webhooks Beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • Versionering URL-based
  • SDK's Python, Node.js, Ruby

Laatste ontwikkelingen bij de GitLab API

GitLab werd in 2011 als open-source Rails-applicatie gelanceerd als alternatief voor GitHub. De REST API begon bij v1 en groeide via v3 (2014) door naar v4 in 2017, dat tot vandaag de stabiele hoofdversie is. In 2019 kwam een GraphQL API voor flexibelere queries. Het platform breidde uit met GitLab CI (2015), container registry, package registry, security scanning, Auto DevOps en project access tokens. Webhooks zijn vanaf het begin de standaard voor event-notificaties. Sinds 2022 publiceert GitLab officiële OpenAPI v2-specs en versioneert via URL-pad (/api/v4/).

API versies

GitLab 17.0 Major release
16 mei 2024

Standaard inschakeling van fine-grained Personal Access Tokens, nieuwe OpenAPI v2-spec en uitbreiding van CI/CD-catalog endpoints.

OpenAPI v2 spec Major release
22 april 2022

Publicatie van een meer complete, auto-gegenereerde OpenAPI v2-specificatie via doc/api/openapi/openapi_v2.yaml.

GraphQL API GA Major release
12 december 2019

Algemene beschikbaarheid van de GraphQL API als alternatief naast REST, met flexibele queries en één endpoint.

REST API v4 Major release
22 september 2017

Lancering van v4 als opvolger van v3, met consistente paginering, betere foutmeldingen en uniforme resource-paden.

GitLab CI Major release
22 september 2015

Integratie van CI/CD-pipelines in GitLab zelf, met endpoints voor pipelines, jobs, runners en triggers.