Menu

Samenvatting van de GitHub API

Automatiseer je hele software-delivery met de GitHub API: van repository-bootstrap tot release-publicatie en security-monitoring. De REST API dekt 1.184 endpoints af en GraphQL biedt flexibele queries voor complexere views; webhooks pushen events realtime naar je eigen systemen.
  • Repositories en code: Maak repositories aan, beheer branches, commits, tags en releases, en synchroniseer code-meta-data met je interne developer portal.
  • Pull requests en code review: Lees, merge en sluit pull requests, request reviews automatisch en koppel checks aan je CI-status.
  • Issues en projecten: Open issues vanuit je ticketsysteem, synchroniseer labels en milestones, en houd projectborden in sync met externe planning-tools.
  • Actions-workflows: Trigger workflows, herstart runs, beheer self-hosted runners en lees logs uit voor centrale build-monitoring.
  • Security en compliance: Verwerk Dependabot-, code-scanning- en secret-scanning-alerts in je SOC, en beheer security advisories en SBOM-exports.
  • Organisaties en teams: Provision gebruikers, teams en repositories vanuit je IdP en automatiseer onboarding via SCIM en GitHub Apps.
API Quick Facts REST, GraphQL
  • Authenticatie OAuth2, Bearer Token, API Key
  • Methods GET (619)POST (184)PATCH (65)DELETE (184)PUT (132)
  • Rate limits 5.000 requests/uur voor authenticated requests (user/PAT), 60/uur voor anonymous; GitHub Apps schalen tot 15.000/uur per installatie; aparte search-API-limiet van 30/minuut.
  • Webhooks Beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • Versionering Header-based
  • SDK's PHP, Python, Node.js, Java, .NET, Ruby

Laatste ontwikkelingen bij de GitHub API

GitHub lanceerde in 2008 als hosted Git-platform en publiceerde kort daarna een v1-REST API. v3 verving die in 2012 en bleef de stabiele basis tot vandaag. Een GraphQL API kwam erbij in 2017, gevolgd door GitHub Actions in 2019 en Codespaces in 2021. Sinds 2022 publiceert GitHub een officiële OpenAPI-spec en versioneert de REST API via een datum-header (X-GitHub-Api-Version: 2022-11-28). Webhooks, GitHub Apps en fine-grained Personal Access Tokens vormen het moderne authenticatiemodel; Copilot- en security-endpoints zijn de meest recente uitbreidingen.

API versies

API version 2022-11-28 Major release
28 november 2022

Introductie van datum-gebaseerde versioning via de X-GitHub-Api-Version header. Officiële OpenAPI 3.0 spec gepubliceerd in github/rest-api-description.

Fine-grained Personal Access Tokens Major release
18 oktober 2022

Beta-lancering van fine-grained PATs met scoping per repository en resource, als veiliger alternatief voor classic tokens.

Codespaces API Major release
11 augustus 2021

Algemene beschikbaarheid van Codespaces met REST endpoints voor het beheren van cloud development environments.

GitHub Actions API Major release
13 november 2019

Lancering van GitHub Actions en bijbehorende REST endpoints voor workflows, jobs, runs, artifacts en self-hosted runners.

GraphQL API v4 Major release
10 mei 2017

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

REST API v3 Major release
1 september 2012

Stabiele REST API v3 verving v2 en bleef de hoofdversie tot de datum-gebaseerde versioning in 2022.