Att arbeta med miljöer blev precis enklare. Som ett resultat av denna Kinsta API-uppdatering introduceras nya sätt att hämta filstrukturdata och utföra selektiva filskjutningar mellan miljöer. Du kan dessutom hämta alla miljöer i en enda begäran när du listar webbplatser.

Dessa tillägg är utformade för att minska antalet anrop som du behöver göra. Som ett resultat kan dina distributioner och utvecklingsverktyg bli snabbare och effektivare.

Hämta fillista för en miljö

Du kan nu hämta den fullständiga katalogstrukturen för en WordPress-miljö med hjälp av Kinsta API. Denna nya endpoint returnerar därefter en rekursiv lista över mappar och undermappar. Då får du med andra ord en tydlig bild av vad som finns inuti varje miljö – inga SSH-inloggningar krävs.

Detta är exempelvis användbart när du bygger interna verktyg, validerar filsökvägar före selektiva distribueringar eller automatiserar miljöuppgifter med precision.

Du kan skicka en begäran till GET till:

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

Här är en exempelförfrågan som använder curl:

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

Svaret innehåller nästlade objekt som representerar kataloger som exempelvis:

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

Varje mapp innehåller namn, sökväg och eventuella underordnade filer, vilket gör den lätt att exempelvis kartlägga eller visualisera.

Selektiv filöverföring mellan miljöer

Den befintliga Push Environment-slutpunkten stöder nu ett mer flexibelt sätt att hantera filöverföringar. Med två nya valfria fält kan du antingen skicka hela miljön eller rikta in dig på specifika kataloger. Detta är exempelvis perfekt för arbetsflöden där du inte vill synkronisera allt.

Du kan skicka en PUT-förfrågan till:

PUT /sites/{site_id}/environments

Använd följande fält för att styra vilka filer som ska inkluderas:

  • push_files_option: Välj mellan "ALL_FILES" eller "SPECIFIC_FILES"
  • file_list: Ange en lista över katalogsökvägar som du vill flytta

Här är ett exempel där curl används för att flytta endast utvalda mappar från en miljö till en annan:

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"
    ]
  }'

Detta selektiva tillvägagångssätt hjälper exempelvis till att:

  • Minska distribueringstiden genom att endast synkronisera det som har ändrats
  • Undvika att skriva över andra tillgångar eller uppladdningar
  • Förbättra kontrollen när ändringar flyttas från iscensättning till produktion

Om du inte inkluderar push_files_option används "ALL_FILES" som standard, för att upprätthålla bakåtkompatibilitet.

Lista webbplatser och deras miljöer i ett anrop

Du kan nu hämta alla ett företagswebbplatser och deras miljöer med ett enda API-anrop. Genom att lägga till frågeparametern include_environments=true till slutpunkten GET /sites innehåller svaret varje webbplats tillhörande miljöer. Som ett resultat finns det inget behov av separata uppföljningsförfrågningar.

Detta är exempelvis användbart för agenturer eller team som hanterar ett stort antal webbplatser, där det kan göra stor skillnad att minimera API-anrop och snabba upp miljö-granskningar.

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

Här är ett exempel på en curl-begäran:

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

Svaret innehåller metadata om webbplatsen (namn, ID osv.) och en lista med miljöer (staging, production osv.).

Kinsta API: Byggt för team som hanterar i stor skala

Dessa API-förbättringar är utformade för att spara tid och minska komplexiteten. Det är exempelvis bra för utvecklare och agenturer som hanterar dussintals (eller hundratals) WordPress-webbplatser.

Du kanske synkroniserar utvalda plugin-filer, bygger interna verktyg eller granskar miljöer över en portfölj. Oavsett vilket hjälper dessa förbättringar till att effektivisera det arbete som du annars skulle behöva göra manuellt i instrumentpanelen.

Du kan utforska dessa nya funktioner i Kinsta API-dokumentationen. Det går dessutom att hoppa direkt in i MyKinsta för att generera din åtkomsttoken och börja bygga.