Det er lige blevet nemmere at arbejde med miljøer. Denne Kinsta API-opdatering introducerer nye måder at hente filstrukturdata på, udføre selektive filskub mellem miljøer og hente alle miljøer i en enkelt anmodning, når du viser websteder.

Disse tilføjelser er designet til at reducere antallet af opkald, du skal foretage, så dine implementeringer og udviklingsværktøjer er hurtigere og mere effektive.

Hent filliste for et miljø

Du kan nu hente den fulde mappestruktur i et WordPress-miljø ved hjælp af Kinsta API. Dette nye endpoint returnerer en rekursiv liste over mapper og undermapper, hvilket giver dig et klart overblik over, hvad der er inde i hvert miljø – ingen SSH-logins kræves.

Dette er især nyttigt, når du bygger interne værktøjer, validerer filstier før selektive implementeringer eller automatiserer miljøopgaver med præcision.

Du kan sende en anmodning til GET:

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

Her er et eksempel på en anmodning ved hjælp af curl:

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

Svaret indeholder indlejrede objekter, der repræsenterer mapper som:

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

Hver mappe indeholder navn, sti og eventuelle børn, hvilket gør det nemt at kortlægge eller visualisere.

Selektivt filskub mellem miljøer

Det eksisterende Push Environment endpoint understøtter nu en mere fleksibel måde at styre filoverførsler på. Med to nye valgfrie felter kan du enten skubbe hele miljøet eller målrette specifikke mapper – perfekt til arbejdsgange, hvor du ikke ønsker at synkronisere alt.

Du kan sende en PUT-anmodning til:

PUT /sites/{site_id}/environments

Brug følgende felter til at styre, hvilke filer der skal inkluderes:

  • push_files_option: Vælg mellem "ALL_FILES" eller "SPECIFIC_FILES"
  • file_list: Angiv en liste over katalogstier, du vil skubbe

Her er et eksempel, der bruger curl til kun at skubbe udvalgte mapper fra et miljø til et andet:

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

Denne selektive tilgang hjælper med at:

  • Reducere implementeringstiden ved kun at synkronisere det, der er ændret
  • Undgå at overskrive andre aktiver eller uploads
  • Forbedre kontrollen, når du skubber ændringer fra staging til produktion

Hvis du ikke inkluderer push_files_option, er standardindstillingen "ALL_FILES", så bagudkompatibiliteten bevares.

Vis websteder og deres miljøer i ét kald

Du kan nu hente alle en virksomheds sites og deres miljøer med et enkelt API-kald. Ved at tilføje forespørgselsparameteren include_environments=true til slutpunktet GET /sites inkluderer svaret hvert websteds tilknyttede miljøer – der er ikke behov for separate opfølgningsanmodninger.

Dette er især nyttigt for bureauer eller teams, der administrerer et stort antal sites, hvor det kan gøre en stor forskel at minimere API-kald og fremskynde miljørevisioner.

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

Her er et eksempel på en curl-anmodning:

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

Svaret indeholder metadata om webstedet (navn, ID osv.) og en indlejret liste over miljøer (staging, production osv.).

Kinsta API: Bygget til teams, der administrerer i stor skala

Disse API-forbedringer er designet til at spare tid og reducere kompleksiteten, især for udviklere og agenturer, der administrerer dusinvis (eller hundredvis) af WordPress-websteder.

Uanset om du synkroniserer udvalgte plugin-filer, bygger interne værktøjer eller reviderer miljøer på tværs af en portefølje, hjælper disse forbedringer med at strømline det arbejde, du ellers skulle udføre manuelt i dashboardet.

Du kan udforske disse nye muligheder i Kinsta API-dokumentationen eller hoppe direkte ind i MyKinsta for at generere dit adgangstoken og begynde at bygge.