Kinstas API har precis fått en ny uppsättning uppdateringar. Som ett resultat får utvecklare och webbplatsansvariga mer kontroll över hur deras webbplatser fungerar i kanten och bakom kulisserna.

Det spelar ingen roll om du utvecklar automatiseringsskript eller bygger anpassade verktyg för din miljö. Dessa tillägg gör det det enklare att exakt hantera CDN-beteende, cache-inställningar och PHP-versionuppdateringar.

Kontrollera bildoptimering

Du kan nu dessutom hantera inställningar för bildoptimering för alla miljöer med hjälp av Kinsta API. Som ett resultat av denna slutpunkt får utvecklare flexibiliteten att justera hur Kinsta komprimerar och serverar bilder. De behöver dessutom inte logga in på MyKinsta.

Detta är exempelvis användbart om du automatiserar distribueringar eller hanterar flera miljöer i stor skala. Beroende på ditt användningsområde kan du välja ett av följande optimeringslägen:

  • off – Inaktiverar bildoptimering helt och hållet.
  • lossy – Tillämpar aggressiv komprimering för mindre filstorlekar och snabbare laddningstider, på bekostnad av viss visuell återgivning.
  • lossless – Komprimerar bilder utan att försämra kvaliteten. Som ett resultat bevaras skärpan samtidigt som filstorleken minskas.

Om du vill uppdatera inställningen för bildoptimering för en miljö skickar du en begäran till PUT:

PUT /sites/cdn/image-optimization

Din begäran bör innehålla environment_id och önskad optimeringstyp. Här är ett snabbt exempel med curl för att tillämpa lossy-optimering:

curl -i -X PUT \
  https://api.kinsta.com/v2/sites/cdn/image-optimization \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment_id": "your-environment-id",
    "image_optimization_type": "lossy"
  }'

Den här uppdateringen ger dig mer kontroll över hur medietillgångar levereras – perfekt för att skräddarsy prestanda i produktions-, iscensättnings- eller medietunga miljöer.

För mer information om hur bildoptimering fungerar på Kinsta, kolla in vår CDN-dokumentation.

Aktivera eller inaktivera edge-cachelagring

Du kan nu växla Edge Caching för en specifik miljö med hjälp av Kinsta API. Som ett resultat av denna nya slutpunkt kan du programmatiskt aktivera eller inaktivera edgecache-lagring. Då får du exempelvis en större kontroll över hur innehåll serveras över Kinstas globala CDN.

Detta är exempelvis användbart under distribueringar, testning eller felsökningsscenarier där du tillfälligt behöver kringgå eller återinföra cachelagrat innehåll.

Du kan skicka en PUT begäran till:

PUT /sites/edge-caching/status

Inkludera fältet environment_id och ett boolean enabled i begärans kropp. Här är en exempelbegäran som använder curl för att aktivera Edge Caching:

curl -i -X PUT \
  https://api.kinsta.com/v2/sites/edge-caching/status \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment_id": "your-environment-id",
    "enabled": true
  }'

Om du ställer in "enabled" till false inaktiveras Edge Caching för den miljön. Detta är exempelvis användbart om du aktivt skickar uppdateringar och vill undvika fördröjningar i cachelagringen.

Välja bort automatiska PHP-uppdateringar

Vi har lagt till en ny nivå av kontroll till Kinsta API för hantering av PHP-versioner. När du ändrar en miljös PHP-version kan du nu inkludera den valfria flaggan is_opt_out_from_automatic_php_update. Som ett resultat kan du välja bort framtida automatiska uppgraderingar.

Den här uppdateringen är särskilt användbar för team som behöver upprätthålla versionskonsistens mellan miljöer eller fördröja uppdateringar för att säkerställa kompatibilitet med anpassad kod, plugins eller äldre beroenden.

Skicka en PUT begäran till:

PUT /sites/tools/modify-php-version

Förfrågan ska innehålla ditt miljö-ID, PHP-målversion och den nya is_opt_out_from_automatic_php_update-flaggan inställd på true eller false. Här är ett exempel på en curl-förfrågan:

curl -i -X PUT \
  https://api.kinsta.com/v2/sites/tools/modify-php-version \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment_id": "your-environment-id",
    "php_version": "8.1",
    "is_opt_out_from_automatic_php_update": true
  }'

Om du ställer in denna flagga till true håller din miljö på den valda PHP-versionen om du inte uppdaterar den manuellt via API eller i MyKinsta-panelen. Ifall flaggan exempelvis utelämnas eller ställs in på false följer miljön Kinstas standardschema för automatisk uppdatering för PHP-versioner som stöds.

För mer information kan du granska vår PHP-hanteringsdokumentation.

Nya fält i miljöns svar

Slutpunkten GET /sites/{site_id}/environments returnerar nu två ytterligare fält som ger bättre insyn i hur varje miljö är konfigurerad:

  • image_optimization_type – Visar den aktuella inställningen för bildoptimering som tillämpas via CDN. Detta kan exempelvis vara "off", "lossy", eller "lossless". Som ett resultat får du hjälp att bekräfta optimeringsnivåer i olika miljöer på ett ögonblick.
  • is_opt_out_from_automatic_php_update – Anger om automatiska PHP-uppdateringar är inaktiverade för miljön. Om inställningen är true kommer miljön inte att få schemalagda PHP-uppgraderingar.

Som ett resultat av denna förbättring blir det enklare att granska och hantera miljöspecifika inställningar programmatiskt. Detta är exempelvis användbart för team som arbetar med instanser för iscensättning, utveckling och produktion.

Här är ett förenklat exempel på ett svarsutdrag:

{
  "id": "your-environment-id",
  "name": "production",
  "image_optimization_type": "lossy",
  "is_opt_out_from_automatic_php_update": true
}

Du kan läsa mer i vår API-referens för slutpunkter för miljöer.

Varför detta är viktigt

De här uppdateringarna handlar om att ge dig mer kontroll, särskilt om du hanterar flera miljöer eller automatiserar ditt arbetsflöde.

  • Finjustera bildprestanda utan att logga in på instrumentpanelen.
  • Hantera Edge Caching-beteende direkt via API, vilket är perfekt för distribuerings-pipelines.
  • Säkerställ PHP-versionskompatibilitet genom att låsa miljöer till en specifik version när det behövs.
  • Granska miljöinställningar i stor skala med nya svarsfält.

Tillsammans gör dessa förändringar det enklare att bygga med Kinsta på dina villkor med hjälp av de verktyg och automatiseringar som redan fungerar för ditt team.

Du hittar fullständiga detaljer om begäran och svar i Kinstas API-dokumentation.