Werken met omgevingen is nu nog eenvoudiger. Deze Kinsta API update introduceert nieuwe manieren om bestandsstructuurgegevens op te halen, selectieve bestands pushes tussen omgevingen uit te voeren en alle omgevingen in één verzoek op te halen bij het opsommen van sites.

Deze toevoegingen zijn ontworpen om het aantal verzoeken dat je moet doen te verminderen, zodat je implementaties en dev tools sneller en efficiënter zijn.

Bestandenlijst ophalen voor een omgeving

Je kunt nu de volledige mappenstructuur van een WordPress omgeving opvragen met de Kinsta API. Dit nieuwe eindpunt retourneert een recursieve lijst van mappen en submappen, zodat je een duidelijk beeld krijgt van wat er in elke omgeving zit – SSH inloggen is niet nodig.

Dit is vooral handig bij het bouwen van interne tools, het valideren van bestandspaden voor selectieve implementaties of het nauwkeurig automatiseren van omgevingstaken.

Je kunt een GET verzoek sturen naar:

GET /sites/environments/{env_id}/file-list

Hier is een voorbeeldverzoek met curl:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/file-list' \
  -H 'Authorization: Bearer '

Het antwoord bevat geneste objecten die mappen vertegenwoordigen zoals:

  • wp-content/
  • wp-content/plugins/
  • wp-content/themes/
  • wp-content/uploads/

Elke map bevat zijn naam, pad en eventuele kinderen, waardoor het eenvoudig is om deze in kaart te brengen of te visualiseren.

Selectief bestanden pushen tussen omgevingen

Het bestaande Push Environment endpoint ondersteunt nu een flexibelere manier om bestandsoverdrachten te beheren. Met twee nieuwe optionele velden kun je de volledige omgeving pushen of specifieke mappen – perfect voor workflows waarbij je niet alles wilt synchroniseren.

Je kunt een PUT verzoek sturen naar:

PUT /sites/{site_id}/environments

Gebruik de volgende velden om te bepalen welke bestanden worden opgenomen:

  • push_files_option: Kies tussen "ALL_FILES" of "SPECIFIC_FILES"
  • file_list: Geef een lijst op met mappaden die je wilt pushen

Hier is een voorbeeld waarbij curl wordt gebruikt om alleen geselecteerde mappen van de ene naar de andere omgeving te pushen:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/{site_id}/environments' \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_env_id": "your-source-env-id",
    "target_env_id": "your-target-env-id",
    "push_db": true,
    "push_files": true,
    "run_search_and_replace": true,
    "push_files_option": "SPECIFIC_FILES",
    "file_list": [
      "wp-content/plugins",
      "wp-content/themes",
      "wp-content/uploads"
    ]
  }'

Deze selectieve aanpak helpt:

  • De implementatietijd te verkorten door alleen te synchroniseren wat is veranderd
  • Voorkomen dat andere assets of uploads worden overschreven
  • Verbeter de controle bij het pushen van wijzigingen van staging naar productie

Als je push_files_option niet opneemt, wordt het standaard "ALL_FILES", waardoor achterwaartse compatibiliteit behouden blijft.

Lijst van sites en hun omgevingen in één oproep

Je kunt nu alle sites van een bedrijf ophalen en en hun omgevingen ophalen met een enkele API-aanroep. Door de include_environments=true query parameter toe te voegen aan het GET /sites endpoint, bevat het antwoord de bijbehorende omgevingen van elke site.

Dit is vooral handig voor bureaus of teams die een groot aantal sites beheren, waar het minimaliseren van API-aanroepen en het versnellen van omgevingscontroles een groot verschil kunnen maken.

GET /sites?company=your-company-id&include_environments=true

Hier is een voorbeeld van een curl verzoek:

curl -i -X GET \
'https://api.kinsta.com/v2/sites?company=your-company-id&include_environments=true' \
  -H 'Authorization: Bearer '

Het antwoord bevat metagegevens over de site (naam, ID, enz.) en een geneste lijst met omgevingen (staging, production, enz.).

Kinsta API: Gebouwd voor teams die op schaal beheren

Deze API verbeteringen zijn ontworpen om tijd te besparen en complexiteit te verminderen, vooral voor ontwikkelaars en bureaus die tientallen (of honderden) WordPress sites beheren.

Of je nu geselecteerde plugin-bestanden synchroniseert, interne tools bouwt of omgevingen in een portfolio controleert, deze verbeteringen helpen het werk te stroomlijnen dat je anders handmatig in het dashboard zou moeten doen.

Je kunt deze nieuwe mogelijkheden verkennen in de Kinsta API documentatie of direct naar MyKinsta gaan om je toegangstoken te genereren en te beginnen met bouwen.