Naamruimten en versies

Deze tekst is vertaald met behulp van AI. Als je de oorspronkelijke tekst in het Engels wilt bekijken, klik dan hier.

De WordPress.com REST API is georganiseerd in drie afzonderlijke naamruimten, die elk specifieke doelen dienen en onafhankelijke versiebeheerschema’s volgen. Inzicht in deze naamruimten is essentieel om de juiste endpoints voor je integratie te kiezen en compatibiliteit met zowel WordPress.com als zelf-gehoste WordPress-sites te garanderen.

Overzicht van API-naamruimten

De WordPress.com REST API biedt drie hoofdnaamruimten, elk gericht op verschillende gebruiksscenario’s en compatibiliteitsniveaus:

Naamruimte	Beschikbare versies	Primair doel	Compatibel met WordPress Core
/rest/	v1, v1.1, v1.2, v1.3, v1.4	Legacy WordPress.com-beheer en platformfuncties	Nee
/wp/	v2	Standaard WordPress core-resources volgens de officiële REST API-specificatie	Ja
/wpcom/	v2, v3, v4	Moderne WordPress.com-specifieke functies en diensten	Nee

/rest/ Naamruimte – Legacy WordPress.com API

De naamruimte /rest/ vertegenwoordigt de oorspronkelijke WordPress.com REST API, die voorafging aan de WordPress core REST API. Deze biedt uitgebreide toegang tot platformfuncties en mogelijkheden voor sitebeheer van WordPress.com.

Beschikbare versies: v1, v1.1, v1.2, v1.3, v1.4 (toegankelijk via de optie WP.COM API in de API Console)

Basis-URL’s:

• https://public-api.wordpress.com/rest/v1/
• https://public-api.wordpress.com/rest/v1.1/
• https://public-api.wordpress.com/rest/v1.2/
• https://public-api.wordpress.com/rest/v1.3/
• https://public-api.wordpress.com/rest/v1.4/

Belangrijkste functies:

• Uitgebreid site- en gebruikersbeheer
• WordPress.com-specifieke functies zoals Statistieken, Reader en Meldingen
• Geavanceerde siteconfiguratie en domeinbeheer
• Mogelijkheden voor Jetpack-integratie

Versiestrategie: Elke versie (v1.1–v1.4) introduceerde incrementele verbeteringen, nieuwe endpoints en uitgebreidere functionaliteit, terwijl achterwaartse compatibiliteit behouden bleef. Wanneer endpoints in meerdere versies bestaan, bieden nieuwere versies meestal extra velden, betere prestaties of bugfixes.

Het meest geschikt voor:

• Toegang tot WordPress.com-specifieke functies die elders niet beschikbaar zijn
• Geavanceerd sitebeheer en configuratie
• Compatibiliteit behouden met bestaande integraties
• Functies zoals gedetailleerde statistieken, Reader-functionaliteit en domeinbeheer

Voorbeeld-endpoints:

• /rest/v1.4/sites/{site}/posts
• /rest/v1.4/sites/{site}/stats
• /rest/v1.4/me/sites
• /rest/v1.3/read/following

/wp/-naamruimte – WordPress Core REST API

De /wp/-naamruimte implementeert de officiële WordPress REST API-specificatie en zorgt voor volledige compatibiliteit met zowel WordPress.com als zelfgehoste WordPress-sites. Deze naamruimte volgt de standaarden die zijn vastgesteld door het WordPress-coreteam.

Beschikbare versie: v2 (toegankelijk via de optie WP REST API in de API Console)

Basis-URL: https://public-api.wordpress.com/wp/v2/

Belangrijkste functies:

• Standaard WordPress-resources (berichten, pagina’s, reacties, taxonomieën, gebruikers, media)
• Volledige compatibiliteit met zelfgehoste WordPress-sites
• Consistente endpointstructuur volgens de WordPress-corestandaarden
• Uitbreidbaar via plugins op zelfgehoste sites

Ontwerpfilosofie: Deze naamruimte geeft prioriteit aan standaardisatie en compatibiliteit boven WordPress.com-specifieke functies. Deze weerspiegelt de REST API die beschikbaar is op elke WordPress-installatie, waardoor deze ideaal is voor applicaties die in verschillende WordPress-omgevingen moeten werken.

Het meest geschikt voor:

• Nieuwe projecten waarvoor WordPress-corefunctionaliteit nodig is
• Applicaties die moeten werken met zowel WordPress.com als zelfgehoste sites
• Standaard contentbeheer (berichten, pagina’s, media, gebruikers)
• Integraties met bestaande WordPress-tools en plugins

Voorbeeld-endpoints:

• /wp/v2/posts
• /wp/v2/pages
• /wp/v2/users
• /wp/v2/media
• /wp/v2/sites/{site}/posts

/wpcom/-naamruimte – Moderne WordPress.com Platform API

De namespace /wpcom/ vertegenwoordigt de evolutie van WordPress.com-specifieke API-functionaliteit, met moderne designpatronen en geavanceerde platformfuncties die niet beschikbaar zijn in WordPress core.

Beschikbare versies: v2, v3, v4 (toegankelijk via de optie WP REST API in de API Console)

Basis-URL’s:

• https://public-api.wordpress.com/wpcom/v2/
• https://public-api.wordpress.com/wpcom/v3/
• https://public-api.wordpress.com/wpcom/v4/

Belangrijkste functies:

• Modern API-design met verbeterde structuur en prestaties
• Geavanceerde WordPress.com-diensten (Reader, verbeterde Statistieken, Meldingen)
• Functies voor gebruikersbetrokkenheid (volgen, likes, aanbevelingen)
• Platformspecifieke functionaliteit is niet beschikbaar in zelf-gehoste WordPress

Versiebeheerstrategie: Elke versie introduceert nieuwe mogelijkheden, beveiligingsverbeteringen en verfijnde datastructuren. In tegenstelling tot de namespace /rest/ richt /wpcom/ zich op toekomstgerichte functionaliteit in plaats van compatibiliteit met verouderde systemen.

Het meest geschikt voor:

• Moderne WordPress.com-platformfuncties
• Gebruikersbetrokkenheid en sociale functies
• Geavanceerde analyses en aanbevelingen
• Nieuwe integraties waarvoor de nieuwste WordPress.com-mogelijkheden nodig zijn

Voorbeeld-endpoints:

• /wpcom/v4/me/follows
• /wpcom/v3/notifications
• /wpcom/v2/read/tags
• /wpcom/v4/sites/{site}/stats/insights

De juiste namespace kiezen

De keuze van de namespace hangt af van je specifieke vereisten en compatibiliteitsbehoeften:

Gebruik /wp/v2/ wanneer je standaard WordPress-functionaliteit nodig hebt, zoals:

• Core WordPress-functies (berichten, pagina’s, gebruikers, media)
• Compatibiliteit met zelf-gehoste WordPress-sites
• Standaard REST API-patronen en -structuren
• Integratie met bestaande WordPress-tools en plugins

Gebruik /wpcom/v4/ (of de nieuwste beschikbare versie) wanneer je WordPress.com-platformfuncties nodig hebt, zoals:

• Geavanceerde WordPress.com-services en sociale functies
• Modern API-ontwerp en verbeterde prestaties
• Nieuwste platformmogelijkheden en integraties
• Functies die uniek zijn voor het WordPress.com-ecosysteem

Gebruik /rest/v1.4/ (of de vereiste versie) wanneer je verouderde functies en compatibiliteit nodig hebt, zoals:

• Specifieke functionaliteit die alleen beschikbaar is in verouderde endpoints
• Achterwaartse compatibiliteit met bestaande integraties
• Geavanceerde functies voor sitebeheer die nog niet zijn gemigreerd naar nieuwere namespaces
• Uitgebreide mogelijkheden voor statistieken en analyses

Richtlijnen voor versieselectie

Binnen elke namespace volgt de versiekeuze deze principes:

Meerdere versies beschikbaar: Wanneer endpoints in meerdere versies bestaan, bieden nieuwere versies doorgaans:

• Extra responsvelden en parameters
• Verbeterde prestaties en betrouwbaarheid
• Bugfixes en beveiligingsverbeteringen
• Uitgebreidere functionaliteit met behoud van achterwaartse compatibiliteit

Aanbevolen aanpak: Gebruik altijd de nieuwste beschikbare versie, tenzij:

• Je integratie afhankelijk is van specifiek gedrag in oudere versies
• Je legacy-code onderhoudt waarvoor specifieke API-responsen nodig zijn
• Compatibiliteitsvereisten een bepaalde versie voorschrijven

De indeling van de API Console begrijpen

De WordPress.com API Console organiseert namespaces in twee hoofdcategorieën:

• WP.COM API: Bevat alle versies van de /rest/-namespace (v1–v1.4)
• WP REST API: Bevat /wp/v2/ en alle versies van de /wpcom/-namespace (v2–v4)

Deze indeling weerspiegelt de ontwikkeling van WordPress.com-specifieke API’s naar gestandaardiseerde WordPress core-API’s en moderne platformfuncties.

Migratieoverwegingen

Bij het plannen van integraties of het bijwerken van bestaande integraties:

Nieuwe projecten: Begin met /wp/v2/ voor kernfunctionaliteit en /wpcom/v4/ voor platformspecifieke functies.

Bestaande integraties: Overweeg te migreren van /rest/-endpoints naar nieuwere namespaces wanneer:

• Er gelijkwaardige functionaliteit bestaat in /wp/v2/ of /wpcom/
• Je betere prestaties of extra functies nodig hebt
• Langdurig onderhoud en ondersteuning prioriteit hebben

Beschikbaarheid van functies: Sommige geavanceerde functies blijven exclusief voor de /rest/-namespace. Evalueer de functievereisten vóór migratie om ervoor te zorgen dat alle benodigde functionaliteit beschikbaar is in de doel-namespaces.