POST/v1/news
posts:writePubliser en nyhet fra appen
Last opp bildet først med POST /v1/media og purpose=post, og send id-en som featured_image. Nyheten publiseres med en gang. Uten Skribb Mer svarer vi 403 app-news-needs-mer. Har nettstedet slått av Nyheter, svarer vi 409 news-disabled. Med dry_run: true får du de samme svarene uten at noe blir skrevet, og 200 når appen kan publisere. Send Idempotency-Key, så er det trygt å prøve igjen om svaret går tapt.
Bodyen du sender
dry_runboolean- true sjekker bare om publikasjonen kan publisere fra appen. Ingen av de andre feltene blir lest.
titlestringpåkrevd- Overskriften, høyst 140 tegn. Kan ikke være tom.
textstring- Noen linjer, høyst 2000 tegn. Hver linje blir et eget avsnitt, og teksten leses som den står, ikke som Markdown.
featured_imageFeaturedImageInput- Bildet, med media-id-en du fikk fra opplastingen.
send_newsletterboolean- true sender nyheten til abonnentene også. Utelater du feltet, går det ingen e-post, til forskjell fra POST /v1/posts.
Svaret · 201
postPostRefikke alltid med- Nyheten som ble publisert. Med i svaret når dry_run ikke er sendt.
newsobjectikke alltid med- { dry_run: true } når du bare spurte. Da er ingenting skrevet.
# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/news" \
-X POST \
-H "content-type: application/json" \
-d '{
"title": "Sommerbrev",
"text": "Vi har åpent til 20 hele uka.",
"send_newsletter": false
}'