Geautomatiseerde inhoudslevering met API

Verbind Monok met uw aangepaste CMS, Express-app of een andere Node.js-backend. Ontvang artikelen als concept via onze eenvoudige API.

Aan de slag

Inhoud geleverd aan

Krachtige API voor naadloze integratie

Het pakket @monok/server maakt het eenvoudig om uw backend met Monok te verbinden. Installeer via npm, configureer uw eindpunt en ontvang automatisch inhoud.

Snelle installatie

Installeer het pakket met npm, maak een router aan en binnen enkele minuten bent u klaar om artikelen te ontvangen. Werkt met Express en elk Node.js-framework.

In 3 stappen aan de slag

Hier is alles wat u nodig heeft om Monok te integreren met uw 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

API-eindpunten

Het pakket @monok/server stelt deze eindpunten automatisch in voor communicatie met Monok

POST

/monok/push?action=draft|publish

Monok pusht nieuwe artikelgegevens naar dit eindpunt. Het artikel wordt verwerkt door uw onArtikel callback.

Koptekst:token: <your-api-key>

Lichaam:JSON-payload met artikelgegevens

Queryparameter:action— Ingesteld op draft of publish gebaseerd op gebruikersselectie in Monok GUI

GET

/monok/info?apikey=<your-api-key>

Monok haalt uw sitegegevens op om meer te weten te komen over uw branding, categorieën, tags en auteurs. Dit zorgt voor betere inhoudsaanbevelingen.

Queryparameter:apikey— Uw Monok API-sleutel voor authenticatie

Configuratie:Vereist dat getSiteInfo callback wordt geconfigureerd

Antwoord:Retourneert 404 als getSiteInfo niet is opgegeven

Artikelgegevensstructuur

Inzicht in de JSON-payload die u van Monok ontvangt

POST-tekstvelden

Artikelen worden verzonden als JSON-objecten met de volgende structuur

Field	Type	Description
`title`	String	De titel van het artikel
`shortTitle`	String	Een kortere titel voor metatags, Yoast/RankMath vooraf ingevuld
`description`	String	Metabeschrijving voor SEO, Yoast/RankMath vooraf ingevuld
`content`	String	Het artikel als WordPress-ready HTML
`text`	String	Het artikel als markdown met JSON-widgets
`slug`	String	URL-slug gegenereerd op basis van de titel, vult Yoast/RankMath vooraf in
`id`	String	Unieke ID, toegankelijk via monok.com/puff/ID
`thumbImageData`	String	Uitgelichte afbeelding als base64-gecodeerde PNG
`thumbImageDescription`	String	Alt-tekst voor de uitgelichte afbeelding
`language`	String	Doeltaal/landinstelling (bijvoorbeeld 'fr', 'fr-ca')
`type`	String	"blog" of "nieuws"
`keywords`	[String]	Array van SEO-zoekwoorden
`tags`	[String]	Array van artikeltags
`vfImage`	Object	Gedetailleerde metagegevens van aanbevolen afbeeldingen
`sections`	String	Categorienaam voor het artikel

Artikeltekstformaat

Het veld text bevat Markdown met ingebouwde JSON-widgets voor rich media zoals tweets, Instagram-berichten, YouTube-video's en citaten.

Voorbeeld: ingebedde tweetwidget

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}

Markdown verwerken

Splits de tekst op nieuwe regels (\n) en valideer of elke regel een markdown of JSON is. Compileer markdown naar HTML met behulp van een bibliotheek zoals Drawdown (~4 KB).

JSON-widgets verwerken

Voor Twitter/YouTube voegt u het URL-veld rechtstreeks in: WordPress herkent insluitingen. Gebruik voor Instagram een iframe. Of gebruik gewoon het veld content voor kant-en-klare HTML.

Aanbevolen aanpak

Voor de meeste integraties (WordPress, Strapi, enz.) gebruikt u het veld content, dat HTML bevat die geschikt is voor WordPress. Dit is eenvoudiger dan het zelf parseren van markdown- en JSON-widgets.

Optioneel maar sterk aanbevolen

Linkbacks verzenden na publicatie

Laat Monok weten waar uw artikelen worden gepubliceerd om sociale-mediacampagnes mogelijk te maken en de onderlinge koppeling voor toekomstige inhoud te verbeteren

Linkback-voorbeeld

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});

Zet sociale campagnes op

Deel automatisch gepubliceerde artikelen op sociale mediaplatforms wanneer Monok de linkback ontvangt

Verbeterde onderlinge koppeling

Monok leert uw gepubliceerde inhoudsstructuur kennen en stelt betere interne links voor toekomstige artikelen voor

Prestatieanalyse

Houd bij hoe uw artikelen presteren en krijg inzicht in de betrokkenheidsstatistieken voor uw inhoud

Eenvoudige integratie

Roep eenvoudigweg sendMonokLinkback() aan na publicatie: Monok regelt de rest

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.

Eenvoudige workflow, krachtige resultaten

Installeer @monok/server via npm. Maak een POST-eindpunt dat artikelgegevens van Monok ontvangt. Afbeeldingen automatisch opslaan. Publiceer onmiddellijk of als concept. Stuur linkbacks wanneer de inhoud live gaat. Dat is alles. Monok regelt de rest.

Problemen oplossen

Veelvoorkomende problemen en hoe u deze kunt oplossen

413 Fout te grote lading

Veel servers beperken de hoeveelheid gegevens die u ernaar kunt verzenden. Wanneer een veld thumbImageData wordt verzonden, kan het deze limiet overschrijden, wat een fout 413 Payload Too Large oplevert.

Solution:

Zorg ervoor dat uw Nginx-waarde voor client_max_body_size groter is dan 5MB.

Eindpuntbeperkingen

In sommige gevallen hebben websites beperkte POST- en GET-aanroepen door eindpunten via Nginx te beperken.

Open de volgende eindpunten:

• website.com/wp-json/monok/* (voor WordPress)
• website.com/monok/* (voor API-integratie)

Het jokerteken is er omdat er twee paden zijn: Nginx-configuraties begrijpen jokertekens.

IP-adresbeperkingen

Als uw Nginx-installatie IP-adressen beperkt, moet u de server van Monok op de witte lijst zetten.

Solution:

Open het voor dit adres: 51.158.177.191

Wat onze klanten zeggen

Werken met Monok is een van de meest innovatieve dingen die we als bedrijf hebben gedaan en is absoluut een gamechanger voor ons. Monok is ons geheime wapen en de toekomst!

Ivan Mackenzie

Hoofd van, Plumjobs

Het werken met Monok is een van onze beste ervaringen met een dienstverlener geweest. De Product Roadmap van Monok voorspelt consequent de behoeften van de markt.

Matt Kovelan

Oprichter, SportsWriters

Met Monok kunnen we SEO-gerichte inhoud schalen zonder interne overhead toe te voegen. Artikelen zijn on-brand, commercieel scherp en gebouwd om onze betaalde acquisitiekanalen te ondersteunen, waardoor bezoekersverkeer wordt omgezet in meetbare klantengroei.

Alexander Westerlund

Oprichter, PPCjuice

De samenwerking met Monok heeft de manier waarop we op mobilen.nu publiceren versterkt. Wat opvalt is niet alleen de snelheid, maar ook de echte nativisering; de inhoud voelt niet vertaald aan, het voelt vanaf het begin geschreven voor een Zweeds publiek.

Joel Carlsson

Oprichter, mobilen.nu

Ik vind het heel goed! Ik gebruikte het voor mijn door Ventura ondersteunde SaaS in het Chinees, de taal was erg goed

Xunzhu Tang, PhD

Oprichter, NoahCode

Werken met Monok is een van de meest innovatieve dingen die we als bedrijf hebben gedaan en is absoluut een gamechanger voor ons. Monok is ons geheime wapen en de toekomst!

Ivan Mackenzie

Hoofd van, Plumjobs

Het werken met Monok is een van onze beste ervaringen met een dienstverlener geweest. De Product Roadmap van Monok voorspelt consequent de behoeften van de markt.

Matt Kovelan

Oprichter, SportsWriters

Alexander Westerlund

Oprichter, PPCjuice

Joel Carlsson

Oprichter, mobilen.nu

Ik vind het heel goed! Ik gebruikte het voor mijn door Ventura ondersteunde SaaS in het Chinees, de taal was erg goed

Xunzhu Tang, PhD

Oprichter, NoahCode

Featured in

Elk onderwerp op schaal

Behandel onderwerpen buiten uw kennisdomein op laag of hoog volume.

Lokaal nieuws

Welzijn & Gezondheid

Financieel nieuws

Sportnieuws

Vastgoed

Fitness en prestaties

Cultuur en levensstijl

Crypto- en Blockchain-nieuws

Prijzen

Plannen die meeschalen met uw redactionele ambities

Elke laag houdt uw productie flexibel. Pauzeer wanneer je maar wilt en betaal alleen voor de verhalen die we leveren.

Valuta

Live tarieven updaten…

Basis

Kickstart geautomatiseerd publiceren

5 €/maand

Eén door mensen geschreven artikel
Social Media marketing voor elk artikel
Pauzeer op elk moment: betaal alleen voor geleverd werk

Starter

Schaal wekelijkse contentdalingen

20 €/maand

Twee door mensen geschreven artikelen per week, één kort en één lang
Social Media marketing voor elk artikel
Pauzeer op elk moment: betaal alleen voor geleverd werk

Aangepast

Bouw je eigen mediahuis

Je bepaalt het volume, de lengte en de frequentie/maandelijks • per artikel

Kies het aantal woorden, de verticale mix en het bezorgritme
Je kiest zelf het aantal en de lengte van elk artikel
Pauzeer op elk moment: betaal alleen voor geleverd werk

Veelgestelde vragen

Veelgestelde vragen over API-integratie

@monok/server is een Node.js-pakket dat Express-middleware biedt voor het ontvangen van artikelen van Monok. Het zorgt voor authenticatie, beeldopslag en biedt hulp bij publicatie- en linkback-meldingen.

Ja, een ontwikkelaar moet de initiële integratie opzetten. Het pakket @monok/server maakt het echter eenvoudig: installeer het gewoon via npm, configureer uw API-sleutel en definieer hoe binnenkomende artikelen moeten worden afgehandeld.

Twee hoofdeindpunten: POST /monok/push ontvangt artikelgegevens (met optionele ?action=draft of ?action=publish queryparam), en GET /monok/info retourneert uw site-informatie indien geconfigureerd (categorieën, tags, auteurs).

Miniatuurafbeeldingen van artikelen worden verzonden als base64-gegevens. Gebruik de saveThumbImage()-helper die wordt geleverd in de onArtikel-callback om ze automatisch op te slaan in de imageDir-directory van uw server.

Ja. Geef een imageDir-optie door aan createMonokRouter() om op te geven waar afbeeldingen moeten worden opgeslagen. Standaard worden afbeeldingen opgeslagen in './uploads'.

Een linkback waarschuwt Monok wanneer een artikel op uw site wordt gepubliceerd. Gebruik sendMonokLinkback() om de openbare URL, titel en miniatuur te verzenden. Dit helpt Monok de prestaties bij te houden en analyses te bieden.

Ja! Het pakket bevat ingebouwde TypeScript-declaraties. U krijgt volledige automatische aanvulling en typecontrole voor artikelobjecten, configuratieopties en helperfuncties.

Momenteel is @monok/server ontworpen voor Express. U kunt het concept echter aanpassen aan andere raamwerken door vergelijkbare POST- en GET-eindpunten te maken die overeenkomen met de API-specificatie.

Uw Monok API-sleutel is beschikbaar in uw accountinstellingen. Sla het veilig op in omgevingsvariabelen (zoals process.env.MONOK_API_KEY) en leg het nooit vast aan versiebeheer.

Het artikelobject omvat: id, titel, tekst (HTML-inhoud), slug, tags, categorie, auteursinformatie, miniatuurafbeeldingsgegevens, taal en andere metagegevens. Volledige TypeScript-typen zijn beschikbaar in het pakket.

Nee. API-integratie is gratis inbegrepen bij uw Monok-abonnement. Het pakket @monok/server is gratis en open source.

Ja. Voer uw Express-app lokaal uit en gebruik een tool als ngrok om deze tijdelijk op internet beschikbaar te stellen. Voeg de ngrok-URL toe aan uw Monok-instellingen om te testen.

Begin vandaag nog met integreren

Verbind Monok binnen enkele minuten met uw platform met onze krachtige API.

Aan de slag

Product

Hosting

Technologie

Integraties