WebCare Connect

Read-only REST-endepunkter for WebCare-rapportering. Installeres på alle WebCare-kunders WordPress-sider.

Endepunkter

Alle krever header X-WebCare-Key: <nøkkel>. Nøkkelen settes opp under Innstillinger → WebCare Connect. Se «API-nøkkel» under.

Viktig

• Alt er read-only. Ingen endepunkter skriver noe.
• Nøkkelen lagres som sha256-hash, ikke i klartekst. En databasedump gir ingen brukbar nøkkel.
• 10 mislykkede nøkkelforsøk innen 15 minutter gir midlertidig sperre (429). Riktig nøkkel slipper alltid gjennom, også under sperre. De siste forsøkene vises på innstillingssiden.
• /inventory returnerer maks 500 sider og 500 innlegg. Treffes grensen, sies det fra i avkortet.
• /links sjekker kun lenker som allerede finnes i sidens publiserte innhold, aldri vilkårlige URL-er sendt inn i forespørselen.
• /links ble lagt til 23.08.2026 som fix for at Cloudflare (eller lignende) kan blokkere et eksternt sitemap-oppslag før det når WordPress – se CHANGELOG 1.1.0 og BESLUTNINGER.md i webcare-rapport-prosjektet.
• Hemmeligheter (API-nøkler o.l. fra andre plugins) returneres aldri – redigeres bort eller listes kun med navn.
• Oppdateringsloggen starter fra aktiveringstidspunktet (logging_since i responsen). Historikk før det finnes ikke.
• BlogVault har ingen offentlig API: kun installert/aktiv/versjon, ikke backup-tall.
• CleanTalk- og Patchstack-datastruktur må verifiseres mot ekte site ved første kjøring: security-responsen lister tilgjengelige option-navn for kartlegging.
• SEOPress-metanøkler (_seopress_titles_title osv.) er standardnøkler – verifiser mot ekte site ved første kjøring.
• Sletting av pluginen fjerner nøkkelhash, vedlikeholdslogg og forsøkslogg (uninstall.php). Vedlikeholdsloggen som rapportene bruker er da borte for godt. Deaktivering rører ingenting.

API-nøkkel

Fra og med 1.1.2 lagres nøkkelen kun som hash i databasen. Den kan ikke hentes fram igjen etter at den er laget. Innstillingssiden viser en nygenerert nøkkel én gang, i 15 minutter, og aldri mer.

Hver kundeside har sin egen nøkkel. En ny kunde påvirker aldri de andre.

Slik gjør du det for en ny kunde:

1. Installer og aktiver pluginen
2. Gå til Innstillinger → WebCare Connect
3. Kopier nøkkelen fra den gule boksen med en gang
4. Lim den inn i en ny fil secrets/webcare_connect_key_<slug>.txt i webcare-rapport-prosjektet (kun nøkkelen, ingen linjeskift). Slug er domenenavnet uten TLD, punktum og bindestrek.
5. Kjør hent_data.py for å bekrefte at den virker

Rakk du ikke å kopiere den? Trykk «Generer ny nøkkel» og kopier den nye. Det kan gjøres så mange ganger som nødvendig, det ødelegger ingenting. Husk bare å oppdatere nøkkelfila, ellers slutter datahentingen for den kunden å virke.

Oppdatering fra 1.1.0/1.1.1: ingen nøkler skal byttes. Den eksisterende nøkkelen hashes automatisk ved første sidelasting etter oppdatering, og fortsetter å virke uendret.

Installasjon

1. Last opp webcare-connect.zip via Plugins → Legg til ny → Last opp
2. Aktiver – API-nøkkel genereres automatisk
3. Følg stegene under «API-nøkkel» over
4. Registrer kunden i kundelisten (kunder.json / Notion-kundemaster)

Oppdatering

Via GitHub-release (repo ingvildkolnes/webcare-connect, må være Public). Se CHANGELOG.md. Ny versjon: bump Version: i webcare-connect.php, oppdater CHANGELOG, zip, release med tag vX.Y.Z + zip som asset.