Guida · posts:write

Pubblicare post con media

Carica una foto, pubblica un post che la usa, poi modificalo o eliminalo. La pubblicazione avviene in due passi: prima il media, poi il post.

Scope: posts:write (più stories:write per le storie e posts:read per rileggere i post).

1. Carica il media#

Invia il file come multipart/form-data in un campo chiamato file. La risposta contiene un mediaId da usare nel passo successivo.

curl https://api.linework.app/open/v1/media \
  -H "Authorization: Bearer $LINEWORK_API_KEY" \
  -F "file=@sunset.jpg"

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("sunset.jpg")], { type: "image/jpeg" }), "sunset.jpg");

const res = await fetch("https://api.linework.app/open/v1/media", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.LINEWORK_API_KEY}` },
  body: form, // do not set Content-Type: fetch adds the multipart boundary
});
const { mediaId } = await res.json();

import os, requests

API = "https://api.linework.app/open/v1"
s = requests.Session()
s.headers["Authorization"] = f"Bearer {os.environ['LINEWORK_API_KEY']}"

with open("sunset.jpg", "rb") as f:
    r = s.post(API + "/media", files={"file": ("sunset.jpg", f, "image/jpeg")}, timeout=120)
r.raise_for_status()
media_id = r.json()["mediaId"]

{ "mediaId": "m_8f2c1a" }

Limiti dei media

I file più grandi falliscono con 413 PAYLOAD_TOO_LARGE; gli altri formati con 400 VALIDATION_ERROR. I media caricati e mai usati in un post possono essere eliminati dopo qualche tempo.

2. Pubblica il post#

curl https://api.linework.app/open/v1/posts \
  -H "Authorization: Bearer $LINEWORK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Golden hour on the lake 🌅", "mediaIds": ["m_8f2c1a"] }'

const res = await fetch("https://api.linework.app/open/v1/posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LINEWORK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ text: "Golden hour on the lake 🌅", mediaIds: [mediaId] }),
});
const post = await res.json();
console.log(post.id);

r = s.post(API + "/posts", json={"text": "Golden hour on the lake 🌅", "mediaIds": [media_id]}, timeout=30)
r.raise_for_status()
post = r.json()
print(post["id"])

Un post può contenere solo testo, solo media, oppure entrambi. Ogni post conta per la quota giornaliera di 50 post per account (quote).

3. Modifica o elimina#

# change the text
curl -X PATCH https://api.linework.app/open/v1/posts/1043 \
  -H "Authorization: Bearer $LINEWORK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Golden hour on Lake Como 🌅" }'

# delete the post
curl -X DELETE https://api.linework.app/open/v1/posts/1043 \
  -H "Authorization: Bearer $LINEWORK_API_KEY"

Puoi modificare ed eliminare solo i tuoi post. Rileggili con GET /posts/{id} o elencali con GET /me/posts (posts:read).

Pubblicare una storia#

Le storie usano lo stesso flusso di caricamento: carica con POST /media, poi crea la storia con il mediaId. Scope stories:write, quota giornaliera 20 storie.

curl https://api.linework.app/open/v1/stories \
  -H "Authorization: Bearer $LINEWORK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "mediaId": "m_8f2c1a" }'

Buone pratiche#

• Pubblica contenuti che le persone vogliono vedere. I contenuti ripetitivi o di riempimento automatico sono spam secondo i Termini dell'API.
• Se POST /posts va in timeout, controlla GET /me/posts prima di ritentare, per evitare duplicati.
• Pubblica solo media di cui hai i diritti.