Automatisk innehållsleverans via API

Anslut Monok till ditt eget CMS, din Express-app eller valfri Node.js-backend. Ta emot artiklar som utkast via vårt enkla API.

Innehåll levererat till

Kraftfullt API för smidig integration

Paketet @monok/server gör det enkelt att ansluta din backend till Monok. Installera via npm, konfigurera din endpoint och börja ta emot innehåll automatiskt.

Snabb installation med npm

Snabb installation

Installera paketet med npm, skapa en router och ta emot artiklar inom några minuter. Fungerar med Express och alla Node.js-ramverk.

Kom igång i tre steg

Här är allt du behöver för att integrera Monok med din Express-app:

1. Install the package

Install the package

1npm install @monok/server express

2. Create the router

Create the router

1import express from "express";
2import { createMonokRouter } from "@monok/server";
3
4const app = express();
5
6app.use(
7 "/monok",
8 createMonokRouter({
9 apiKey: process.env.MONOK_API_KEY!,
10 onArticle: async (article, { saveThumbImage, action }) => {
11 const imagePath = await saveThumbImage();
12
13 if (action === "publish") {
14 // publish immediately in your CMS
15 } else {
16 // save as draft (default)
17 }
18 }
19 })
20);
21
22app.listen(3000);

3. Configure your webhook

Add your endpoint URL to Monok settings: https://yoursite.com/monok

Configure webhook in Monok settings

API-endpoints

Paketet @monok/server skapar automatiskt dessa endpoints för kommunikation med Monok

POST
/monok/push?action=draft|publish

Monok skickar nya artikeldata till denna endpoint. Artikeln hanteras av din onArticle-callback.

Header:token: <your-api-key>
Body:JSON-data med artikelinnehåll
Frågeparameter:action— Ange draft eller publish utifrån användarens val i Monoks gränssnitt
GET
/monok/info?apikey=<your-api-key>

Monok hämtar information om din webbplats för att förstå ditt varumärke, dina kategorier, taggar och författare. Det ger bättre innehållsrekommendationer.

Frågeparameter:apikey— Din Monok-API-nyckel för autentisering
Konfiguration:Kräver att callbacken getSiteInfo är konfigurerad
Svar:Returnerar 404 om getSiteInfo inte har angetts

Artikelns datastruktur

Förstå de JSON-data du får från Monok

Fält i POST-body

Artiklar skickas som JSON-objekt med följande struktur

FieldTypeDescription
titleStringArtikelns rubrik
shortTitleStringEn kortare rubrik för metataggar, förifyller Yoast/RankMath
descriptionStringMetabeskrivning för SEO, förifyller Yoast/RankMath
contentStringArtikeln som HTML anpassad för WordPress
textStringArtikeln som Markdown med JSON-widgetar
slugStringURL-slugg skapad från rubriken, förifyller Yoast/RankMath
idStringUnikt ID, tillgängligt på monok.com/puff/ID
thumbImageDataStringUtvald bild som base64-kodad PNG
thumbImageDescriptionStringAlt-text för den utvalda bilden
languageStringMålspråk/språkvariant (t.ex. "fr", "fr-ca")
typeString"blog" eller "news"
keywords[String]Lista med SEO-nyckelord
tags[String]Lista med artikeltaggar
vfImageObjectDetaljerade metadata för den utvalda bilden
sectionsStringArtikelns kategorinamn

Artikeltextens format

Fältet text innehåller Markdown med inbäddade JSON-widgetar för bland annat tweets, Instagram-inlägg, YouTube-videor och citat.

Exempel: widget för inbäddad tweet

JSON Widget in Article Text

1{
2 "data": [
3 {
4 "name": "Phil Spencer",
5 "text": "Had good calls this week with leaders at Sony..."
6 }
7 ],
8 "id": "1484273335139651585",
9 "type": "twitter",
10 "url": "https://twitter.com/XboxP3/status/1484273335139651585",
11 "username": "XboxP3"
12}

Bearbeta Markdown

Dela texten vid radbrytningar (\n) och kontrollera om varje rad är Markdown eller JSON. Omvandla Markdown till HTML med ett bibliotek som Drawdown (~4 KB).

Hantera JSON-widgetar

För Twitter/YouTube kan du infoga URL-fältet direkt – WordPress känner igen inbäddningar. Använd en iframe för Instagram. Eller använd fältet content för färdig HTML.

Rekommenderat tillvägagångssätt

För de flesta integrationer (WordPress, Strapi osv.) kan du använda fältet content, som innehåller HTML anpassad för WordPress. Det är enklare än att själv tolka Markdown och JSON-widgetar.

Valfritt men rekommenderas starkt

Skicka länkåterkoppling efter publicering

Berätta för Monok var dina artiklar publiceras för att möjliggöra kampanjer i sociala medier och förbättra internlänkningen i framtida innehåll

Exempel på länkåterkoppling

1import { sendMonokLinkback } from "@monok/server";
2
3await sendMonokLinkback({
4 monokId: article.id,
5 publicUrl: "https://example.com/blog/" + (article.slug ?? article.id),
6 title: article.title,
7 articleTextSample: article.text?.slice(0, 500),
8 thumbnailUrl: "https://example.com/uploads/" + imageFile
9});

Starta kampanjer i sociala medier

Dela publicerade artiklar automatiskt på sociala medier när Monok tar emot länkåterkopplingen

Bättre internlänkning

Monok lär sig strukturen i ditt publicerade innehåll och föreslår bättre interna länkar för framtida artiklar

Resultatanalys

Följ hur dina artiklar presterar och få insikter om engagemanget i ditt innehåll

Enkel integration

Anropa bara sendMonokLinkback() efter publicering – Monok sköter resten

Advanced Configuration

Enhanced Integration with Site Info

Provide your site information to Monok for better content matching. Monok will automatically align categories, authors, and tags with your existing structure.

Advanced Setup with Site Info

1import express from "express";
2import {
3 createMonokRouter,
4 sendMonokLinkback,
5 type MonokArticle
6} from "@monok/server";
7
8const app = express();
9
10app.use(
11 "/monok",
12 createMonokRouter({
13 apiKey: process.env.MONOK_API_KEY!,
14 imageDir: "./uploads", // optional
15 // Optional: provide site info if you want Monok to query it
16 getSiteInfo: {
17 js_scripts: "Enabled",
18 version: "1.0.0",
19 name: "My Site",
20 logo: "https://example.com/logo.png",
21 categories: ["Content", "News Articles", "Uncategorized"],
22 post_types: ["post", "page"],
23 tags: ["Tech", "Health", "News"],
24 authors: [
25 {
26 name: "Jane Doe",
27 profile: "Editor-in-chief",
28 id: "1",
29 avatar: "https://example.com/avatars/jane.png",
30 roles: ["administrator"]
31 }
32 ]
33 },
34 onArticle: async (article: MonokArticle, { saveThumbImage, action }) => {
35 const imagePath = await saveThumbImage();
36 console.log("Received article:", article.title);
37
38 if (action === "publish") {
39 // publish immediately
40 } else {
41 // save as draft
42 }
43
44 // when you publish later, notify Monok:
45 // await sendMonokLinkback({
46 // monokId: article.id,
47 // publicUrl: "https://example.com/blog/" + (article.slug ?? article.id),
48 // title: article.title,
49 // articleTextSample: article.text?.slice(0, 500),
50 // thumbnailUrl: imagePath
51 // ? "https://example.com/uploads/" + require("path").basename(imagePath)
52 // : undefined
53 // });
54 }
55 })
56);
57
58app.listen(3000);

Automatic Category Matching

Monok learns your existing categories and automatically assigns articles to the most relevant ones based on content analysis.

Author Attribution

Provide your author list so Monok can suggest or assign the appropriate author to each article based on topic and expertise.

Smart Tag Suggestions

Monok uses your existing tag taxonomy to suggest relevant tags for each article, maintaining consistency across your content.

Branding Integration

Share your site name and logo with Monok to ensure all generated content aligns with your brand identity and guidelines.

Optional but Highly Recommended

The getSiteInfo configuration is entirely optional. However, providing this information significantly improves content quality and relevance by allowing Monok to understand your site's structure and existing content organization.

Enkelt arbetsflöde, kraftfulla resultat

Installera @monok/server via npm. Skapa en POST-endpoint som tar emot artikeldata från Monok. Spara bilder automatiskt. Publicera direkt eller spara som utkast. Skicka länkåterkoppling när innehållet publiceras. Monok sköter resten.

Felsökning

Vanliga problem och hur du löser dem

Felet 413 Payload Too Large

Många servrar begränsar mängden data som kan skickas till dem. Fältet thumbImageData kan göra att gränsen överskrids och orsaka felet 413 Payload Too Large.

Solution:

Se till att värdet för client_max_body_size i Nginx är större än 5 MB.

Begränsade endpoints

Vissa webbplatser begränsar POST- och GET-anrop genom att blockera endpoints i Nginx.

Tillåt följande endpoints:

  • • website.com/wp-json/monok/* (för WordPress)
  • • website.com/monok/* (för API-integration)

Jokertecknet täcker de två sökvägarna och måste hanteras i din Nginx-konfiguration.

IP-adressbegränsningar

Om din Nginx-konfiguration begränsar IP-adresser behöver du tillåta Monoks server.

Solution:

Tillåt denna adress: 51.158.177.191

Det säger våra kunder

Jag tycker det är väldigt bra! Jag använde det för min ventura-backade SaaS på kinesiska, språket var väldigt bra

Xunzhu Tang, PhD

Xunzhu Tang, PhD

Grundare, NoahCode

Plumjobs

Att arbeta med Monok är en av de mest innovativa sakerna vi har gjort som företag och det är verkligen en game changer för oss. Monok är vårt hemliga vapen och framtiden!

Ivan Mackenzie

Ivan Mackenzie

Teamchef, Plumjobs

SportsWriters

Att arbeta med Monok har varit en av våra bästa upplevelser med en tjänsteleverantör. Monoks produktplan förutspår konsekvent marknadens behov.

Matt Kovelan

Matt Kovelan

Grundare, SportsWriters

Monok har visat sig vara den idealiska partnern och har på ett ögonblick placerat oss år före planen och dramatiskt förändrat flexibiliteten i vårt erbjudande.

Michael Davids

Michael Davids

VD, Splendor

Jag tycker det är väldigt bra! Jag använde det för min ventura-backade SaaS på kinesiska, språket var väldigt bra

Xunzhu Tang, PhD

Xunzhu Tang, PhD

Grundare, NoahCode

Plumjobs

Att arbeta med Monok är en av de mest innovativa sakerna vi har gjort som företag och det är verkligen en game changer för oss. Monok är vårt hemliga vapen och framtiden!

Ivan Mackenzie

Ivan Mackenzie

Teamchef, Plumjobs

SportsWriters

Att arbeta med Monok har varit en av våra bästa upplevelser med en tjänsteleverantör. Monoks produktplan förutspår konsekvent marknadens behov.

Matt Kovelan

Matt Kovelan

Grundare, SportsWriters

Monok har visat sig vara den idealiska partnern och har på ett ögonblick placerat oss år före planen och dramatiskt förändrat flexibiliteten i vårt erbjudande.

Michael Davids

Michael Davids

VD, Splendor

Featured in

Vilket ämne som helst i skala

Täck ämnen utanför din expertis med låg eller hög volym.

Cover 1
Lokala Nyheter
Cover 2
Hälsa & Välmående
Cover 3
Finansnyheter
Cover 4
Sportnyheter
Cover 5
Fastigheter
Cover 6
Träning & Prestation
Cover 7
Kultur & Livsstil
Cover 8
Krypto & Blockchain

Prissättning

Planer som växer med dina ambitioner

Alla nivåer håller produktionen flexibel. Pausa när du vill och betala bara för det vi levererar.

Valuta

Uppdaterar kurser…

Basic

Paper plane preparing for takeoff
5 €/månad
  • En mänskligt skriven artikel
  • Social media-marknadsföring för varje artikel
  • Pausa när som helst — betala bara levererat arbete
Perfekt för att testa Monok med månatlig produktion.

Starter

Paper plane climbing in altitude
20 €/månad
  • Två artiklar per vecka, en kort och en lång
  • Social media-marknadsföring för varje artikel
  • Pausa när som helst — betala bara levererat arbete
Perfekt för team som ersätter frilansare med pålitligt flöde.

Custom

Paper plane in formation
Du väljer volym, längd och frekvens/månatlig • per artikel
  • Välj ordantal, vertikal mix och leveransrytm
  • Du bestämmer mängd och längd på varje artikel
  • Pausa när som helst — betala bara levererat arbete
Full kontroll — starta eller pausa dina flöden när du vill

Vanliga frågor

Vanliga frågor om API-integration

@monok/server är ett Node.js-paket med Express-middleware för att ta emot artiklar från Monok. Det hanterar autentisering och bildlagring och innehåller hjälpfunktioner för publicering och länkåterkoppling.

Ja, en utvecklare behöver göra den första integrationen. Paketet @monok/server förenklar arbetet: installera via npm, ange din API-nyckel och definiera hur inkommande artiklar ska hanteras.

Två huvudsakliga endpoints: POST /monok/push tar emot artikeldata (med den valfria frågeparametern ?action=draft eller ?action=publish), och GET /monok/info returnerar webbplatsinformation om den har konfigurerats (kategorier, taggar och författare).

Artikelbilder skickas som base64-data. Använd hjälpfunktionen saveThumbImage() i callbacken onArticle för att automatiskt spara dem i serverns imageDir-katalog.

Ja. Ange alternativet imageDir i createMonokRouter() för att välja lagringsplats. Som standard sparas bilder i './uploads'.

Länkåterkoppling meddelar Monok när en artikel publiceras på din webbplats. Använd sendMonokLinkback() för att skicka artikelns publika URL, rubrik och bild. Det hjälper Monok att följa resultat och ge analysdata.

Ja! Paketet innehåller TypeScript-deklarationer. Du får automatisk kodkomplettering och typkontroll för artikelobjekt, konfigurationsalternativ och hjälpfunktioner.

För närvarande är @monok/server utformat för Express. Du kan anpassa lösningen till andra ramverk genom att skapa motsvarande POST- och GET-endpoints som följer API-specifikationen.

Din Monok-API-nyckel finns i kontoinställningarna. Förvara den säkert i miljövariabler (som process.env.MONOK_API_KEY) och checka aldrig in den i versionshanteringen.

Artikelobjektet innehåller id, title, text, content (HTML), slug, taggar, kategori, författarinformation, bilddata, språk och andra metadata. Fullständiga TypeScript-typer finns i paketet.

Nej. API-integration ingår i din Monok-prenumeration utan extra kostnad. Paketet @monok/server är gratis och har öppen källkod.

Ja. Kör din Express-app lokalt och använd ett verktyg som ngrok för att tillfälligt göra den tillgänglig på internet. Lägg till ngrok-URL:en i Monoks inställningar för att testa.

Börja integrera idag

Anslut Monok till din plattform på några minuter med vårt kraftfulla API.