Guía · posts:write

Publicar con contenido multimedia

Sube una foto, publica un post que la use y después edítalo o elimínalo. Publicar es un proceso en dos pasos: primero el contenido multimedia y luego el post.

Scopes: posts:write (y stories:write para las historias, posts:read para volver a leer los posts).

1. Sube el contenido multimedia#

Envía el archivo como multipart/form-data en un campo llamado file. La respuesta contiene un mediaId que usarás en el paso siguiente.

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" }

Límites del contenido multimedia

Los archivos más grandes fallan con 413 PAYLOAD_TOO_LARGE; los demás formatos, con 400 VALIDATION_ERROR. El contenido multimedia subido que nunca se use en un post puede eliminarse pasado un tiempo.

2. Publica el 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 puede tener solo texto, solo contenido multimedia o ambos. Cada post cuenta para la cuota diaria de 50 posts por cuenta (cuotas).

3. Edita 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"

Solo puedes editar y eliminar tus propios posts. Vuelve a leerlos con GET /posts/{id} o lístalos con GET /me/posts (posts:read).

Publicar una historia#

Las historias usan el mismo proceso de subida: sube el archivo con POST /media y después crea la historia con el mediaId. Scope stories:write, cuota diaria de 20 historias.

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

Buenas prácticas#

• Publica contenido que la gente quiera ver. El contenido de relleno repetitivo o automatizado se considera spam según los Términos de la API.
• Si POST /posts agota el tiempo de espera, comprueba GET /me/posts antes de reintentar, para evitar duplicados.
• Publica solo contenido multimedia sobre el que tengas derechos.