Kinstas REST API (Application Programming Interface) er et kraftfuldt værktøj designet til at give udviklere let adgang til og interagere med din Kinsta-konto og projekter. Vores API giver en strømlinet og effektiv måde at arbejde med vores platform på, så du effektivt kan hente data, udføre handlinger og automatisere opgaver.

Forudsætninger

For at bruge Kinstas API skal du have en konto og mindst et WordPress-websted, en applikation eller en database i MyKinsta. Du skal også generere en API-nøgle for at godkende og få adgang til din konto via API’en.

Almindelige brugssager

Rapportering

API’er kan bruges til at læse data, så du kan oprette dine egne rapporter eller integrere Kinsta Services i dine interne sporingssystemer. For eksempel, hvis du driver et bureau og bruger en applikation, der viser alle dine kunder, kan du bruge API’et til at liste alle de Kinsta-hostede WordPress-websteder, applikationer og databaser, der tilhører hver klient.

Planlagte opgaver

Du kan oprette din egen applikation til at planlægge opgaver natten over, der kan påvirke dit websteds ydeevne eller forårsage nedetid. Hvis du f.eks. rydder sidens cache natten over, kan det hjælpe med at minimere forstyrrelser for dine besøgende.

Administration af websted

Ved at bruge Node.js med API’en kan du oprette en Slackbot til administration af websteder for at spare dig tid og hjælpe dig med at administrere dine websteder mere effektivt. Du kan bruge Slackbot til opgaver som at tjekke webstedsstatus, rydde et websteds cache og genstarte et websteds PHP-motor.

Oprettelse af WordPress-sider

Du kan tilføje en ny WordPress-side/installation automatisk ved hjælp af API’en. Hvis du f.eks. driver et bureau og ønsker at kunne automatisere oprettelsesprocessen uden at skulle logge ind på MyKinsta hver gang, kan du bruge API’en til at oprette webstedet og installere WooCommerce, Yoast SEO og Easy Digital Downloads.

Du har også mulighed for at oprette en WordPress Multisite-installation (is_multisite TRUE) og konfigurere et underdomæne (is_subdomain_multisite TRUE) eller underkatalog (is_subdomain_multisite FALSE).

Du kan tjekke status for oprettelsen af siden ved at bruge Operations-endpoint.

Autentificering og brugeradgang

For at få adgang til og bruge API’en med din konto, skal du først generere en API-nøgle i MyKinsta. For at komme i gang skal du gå til siden API-nøgler (Dit navn > Firmaindstillinger > API-nøgler) og klikke på Opret API-nøgle.

  1. Vælg en udløbsdato, eller indstil en brugerdefineret startdato og antal timer, nøglen skal udløbe.
  2. Giv nøglen et navn.
  3. Klik på Generer.

Når API-nøglen er givet, er det den eneste gang, du kan se den. Sørg for at kopiere den og gemme den et sikkert sted.

Virksomhedsejere, virksomhedsadministratorer og virksomhedsudviklere kan oprette API-nøgler. Niveauet for adgang til API’en afhænger af brugerens adgang. For eksempel vil en API-nøgle genereret af en virksomhedsudvikler ikke have den samme adgang som en nøgle genereret af en virksomhedsejer eller administrator.

Du kan generere flere API-nøgler, som er listet på siden API-nøgler. Hvis du har brug for at tilbagekalde en API-nøgle, skal du klikke på Revoke ved siden af den, du vil tilbagekalde.

Tjek status for operationer

Ved potentielt langvarige operationer (f.eks. oprettelse af side, rydning af cache, genstart af PHP osv.) svarer API’en ikke med det samme med resultatet. Dette hjælper med at forhindre en potentiel blokeret servertråd eller gateway-timeout på grund af en operation, der tager lang tid.

For at tjekke status for en handling skal du bruge /operations endpoint. Når du starter en handling, vil det umiddelbare svar fra API’en indeholde en operation_id til brug med /operations endpoint. For flere detaljer og eksempler, se Operations-referencen.

Hastighedsgrænse

For at beskytte vores API mod at blive oversvømmet med for mange anmodninger, er antallet af anmodninger pr. minut begrænset til 60. Der er en undtagelse for oprettelse af sider, som er begrænset til 5 anmodninger pr. minut.

For at se din aktuelle rate limit-status skal du tjekke RateLimit-headerne i det seneste API-svar:

RateLimit-Limit: 60

RateLimit-Resterende: 50

RateLimit-Reset: 60

I øjeblikket er det ikke muligt at øge hastighedsgrænsen.

Fejlfinding

Hvis du laver en anmodning til et endpoint, som din API-nøgle ikke har adgang til, vil du modtage en fejlmeddelelse, der fortæller dig, at du ikke har adgang. Hvis du har brug for adgang til det pågældende endpoint, skal en virksomhedsejer eller administrator generere en API-nøgle til dig.

API-reference

Se vores API-reference for alle detaljer om tilgængelige API-endpoints, for at downloade vores OpenAPI-specifikation og for at afprøve endpoints.

Relateret dokumentation

Refereret indhold