Hoppa till huvudinnehållet
KungoraKungora

Så fungerar Kungora

API, webhooks och widgetar

Läs och publicera innehåll från dina egna system, få signerade webhooks när nyheter ändras och visa dina nyheter på din egen webbplats.

Vill du ta hjälp av en AI?

Skicka den här länken till din chatbot (till exempel ChatGPT, Claude eller Gemini) så kan den förklara hur Kungora fungerar och svara på dina frågor.

https://kungora.com/sv/guide.md

Det öppna API:t

Det publika API:t v1 ger publicerat innehåll som JSON över HTTPS. API-referensen listar alla anrop, fält och webhooks med exempel (på engelska), och OpenAPI 3.1-dokumentet är till för kodgeneratorer och API-klienter. Sidan API för utvecklare på den publika webbplatsen sammanfattar det.

Det här kan du göra utan nyckel: läsa nyhetsrum och deras nyheter, söka och få sökförslag, hämta nyheter via organisationsnummer och läsa taxonomierna (ämnen, regioner, branscher och meddelandetyper). Svaren använder markörbaserad sidindelning och svaga ETags för villkorliga anrop, och CORS tillåter alla ursprung. Utan nyckel får du göra 60 anrop per minut och nätverk.

Med en API-nyckel kan du också skriva, om nyckeln har skrivbehörighet: skapa och ändra utkast, publicera, ladda upp media och anmäla följare med dubbel bekräftelse. Att publicera via API:t följer samma kontroller och mejlregler som instrumentpanelen, inklusive granskningen av de första publiceringarna (Publicering).

API-nycklar

Administratörer och ägaren skapar nycklar under API-nycklar i organisationens Inställningar. Andra medlemmar kan läsa listan. För varje nyckel anger du ett namn, väljer vad den får göra (Läsa publicerat innehåll och Skapa utkast, publicera, ladda upp media och lägga till följare) och när den går ut (efter 30 dagar, efter 90 dagar, efter ett år eller aldrig).

  • Nyckeln visas en gång, när du skapar den. Kopiera den direkt och förvara den bland systemets hemliga inställningar.
  • Skicka den i varje anrop som rubriken Authorization: Bearer följt av nyckeln, bara från dina servrar. Lägg den aldrig på en webbsida eller i en app som andra kan ladda ned.
  • En nyckel höjer gränsen till 600 anrop per minut.
  • En nyckel gäller för hela organisationen, i namnet på den som skapade den. Lämnar personen organisationen kan nyckeln inte längre skriva.
  • Du ser när varje nyckel användes senast och kan återkalla den med knappen som till exempel lyder Återkalla nyckeln Webbplatsen. System som använder den slutar fungera direkt.

Villkor för innehåll du hämtar

Det du hämtar tillhör avsändaren. När du återger en nyhet anger du nyhetsrummet och Kungora som källa, länkar till nyheten och följer varje bilds licens och upphov. Presskontakters namn och arbetsuppgifter finns där för pressfrågor om nyheten och inget annat: använd dem aldrig för marknadsföring, utskickslistor eller profilering, och bygg aldrig ett register över dem. När en nyhet svarar 410 eller 404 raderar du din kopia och personuppgifterna i den. Användarvillkoren gäller.

Webhooks

Webhooks talar om för dina egna system när en nyhet publiceras, uppdateras, avpubliceras eller tas bort. Administratörer och ägaren lägger till slutpunkter under Webhooks, upp till 10 per organisation, var och en med sin egen signeringshemlighet.

  • En slutpunkt är en https-adress på standardporten som svarar på det publika internet. Du väljer vilka händelser den får: ny publicering, publicering uppdaterad, avpublicerad eller borttagen. Importerade nyheter lämnas utanför om du inte väljer dem, så att en import inte skickar hundratals meddelanden.
  • Vi skickar ett signerat JSON-meddelande. Formatet följer Standard Webhooks, så deras bibliotek kan kontrollera det: rubrikerna webhook-id (samma vid varje försök, så använd det för att ignorera upprepningar), webhook-timestamp och webhook-signature, som är v1 följt av Base64-kodad HMAC-SHA256 av id:t, tidsstämpeln och innehållet, med hemligheten som nyckel. Innehållet har typen, en tidsstämpel och data med bara id:n och publicerade fakta, bland dem en länk till nyhetens sida medan den är offentlig och dess api_url.
  • Svara med en 2xx-status inom 10 sekunder. Allt annat, omdirigeringar inräknade, räknas som ett misslyckande. En misslyckad leverans försöks om i ungefär tre dygn, och en slutpunkt där varje leverans misslyckas i flera dygn i rad stängs av. Avvisa meddelanden vars tidsstämpel avviker mer än fem minuter.
  • Hemligheten visas en gång. Skapa en ny hemlighet signerar från och med då, medan den gamla fortsätter att signera i 24 timmar så att du kan byta utan att förlora meddelanden.
  • Du kan välja Pausa slutpunkten (händelser från tiden under pausen skickas inte senare), Skicka ett testmeddelande och läsa Leveranslogg för de senaste 30 dagarna, med utfallet av varje försök, och skicka ett meddelande igen.

Widgetar för din webbplats

Under Widgetar i nyhetsrummets inställningar bygger du en widget, kontrollerar förhandsvisningen och kopierar koden. Det finns tre:

  • Nyhetsflöde: de senaste pressmeddelandena, nyheterna, blogginläggen och evenemangen med länkar till nyhetsrummet. Du väljer typer, antal, lista eller kort med bilder, om länkarna öppnas i samma flik, en ny flik eller ett fönster på din sida, språk (engelska eller svenska), rubriknivå och, om du vill, en av nyhetsrummets kategorier. Flödet följer sidans typsnitt och färger, som du kan justera med CSS-variabler.
  • Följformulär: läsare följer nyhetsrummet via e-post, med dubbel bekräftelse.
  • Bevakningsformulär: läsare får nya meddelanden som matchar ett urval (det här nyhetsrummet eller alla nyhetsrum, typer, ett ämne, en region, en bransch) via e-post, med dubbel bekräftelse.

Koden finns i de former som passar din webbplats: en Webbkomponent (rekommenderas) (lägg till skriptet en gång per sida och elementet där widgeten ska visas, och en kontrollsumma (SRI) gör att webbläsaren bara kör vår oförändrade fil), en iframe, HTML från servern för webbplatser utan JavaScript, ett JSON Feed och en Enkel länk. Sidan listar också de källor som ska tillåtas om din webbplats har en Content Security Policy.

Flöden

Varje nyhetsrum har flöden i RSS 2.0, Atom 1.0 och JSON Feed 1.1, på https://kungora.com/feeds/ditt-nyhetsrum.rss och, med ändelserna .atom och .json, i de två andra formaten. Nyhetsportalen har https://kungora.com/feeds/news.rss och https://kungora.com/feeds/news.json, som tar emot samma filter som portalens flöde. Ett nyhetsrum på egen domän har sina flöden där, på /rss och /feed.json.

För AI-assistenter listar llms.txt nyhetsportalen och nyhetsrummen, och den här guiden finns som ett enda Markdown-dokument på https://kungora.com/sv/guide.md.