Gå til indhold
Opret gratis konto

Hjælp

API og webhooks

Forbind en specialbygget hjemmeside med Livas API eller signerede webhooks, og se, hvornår forbindelsen tæller.

Hvad kan API’et?

API’et er til hjemmesider og systemer, som Liva ikke har en færdig forbindelse til. Din integration henter de godkendte artikler, udgiver dem på din platform og fortæller Liva den offentlige adresse.

  • Hent godkendte artikler, billeder og inkluderede netværkslinks.
  • Modtag en signeret hændelse, når en ny artikel godkendes.
  • Bekræft den offentlige adresse. Liva kontrollerer siden, før artiklen står som udgivet.

Opret en API-nøgle

  1. Åbn Indstillinger → Udgivelse → Til udviklere for hjemmesiden.
  2. Klik på Opret API-nøgle.
  3. Gem denne nøgle nu. Den vises kun én gang.
  4. Læg nøglen på din server, aldrig i kode, der kører i browseren.

En nøgle gælder for én hjemmeside. Med Udskift API-nøgle eller Tilbagekald API-nøgle stopper den gamle nøgle med det samme. Kun hjemmesidens ejer og administratorer kan administrere integrationer.

Opsæt en webhook

  1. Skriv adressen på dit endpoint under Webhook-URL. Den skal være offentlig og bruge HTTPS.
  2. Klik på Gem webhook, og gem signeringsnøglen. Den vises kun én gang.
  3. Klik på Send test, og se resultatet under Leveringshistorik.

Webhooks sendes kun for fremtidige godkendelser. Tidligere godkendte artikler hentes med API’et. Mislykkede leveringer prøves igen automatisk, og du kan selv prøve igen fra leveringshistorikken.

Hvornår er hjemmesiden forbundet via API?

Hjemmesiden tæller først som forbundet via API, når din API-nøgle er brugt mindst én gang, eller når en webhook er leveret mindst én gang. Det er ikke nok at oprette en nøgle eller gemme en webhook.

Godt at vide

En testlevering tæller også. Brug Send test for at bekræfte din webhook med det samme.

Liva kontrollerer og godkender nye daglige artikler automatisk på det gemte udgivelsestidspunkt. Din API-integration udgiver dem.

Forbind kun et CMS, hvis Liva skal udgive direkte i stedet for din API-integration.

Fra godkendt til udgivet

  1. Hent artiklen, og reservér den, før du udgiver. Så kan den ikke ændres imens.
  2. Udgiv artiklen på din hjemmeside med titel, hele teksten, kilder og billede.
  3. Send den offentlige adresse til Liva. Liva åbner siden og markerer artiklen som udgivet, når indholdet stemmer.

Godt at vide

En leveret webhook er ikke en udgivet artikel. Liva kontrollerer den offentlige URL, før udgivelsen registreres.

Den tekniske dokumentation med eksempler, signaturer og grænser findes på engelsk.

Fandt du ikke svaret?

Skriv til os, så hjælper vi dig videre.

team@liva.so