Guide · posts:write

Publier avec des médias

Importez une photo, publiez un post qui l'utilise, puis modifiez-le ou supprimez-le. La publication se fait en deux étapes : d'abord le média, ensuite le post.

Scopes : posts:write (ainsi que stories:write pour les stories et posts:read pour relire les posts).

1. Importer le média#

Envoyez le fichier en multipart/form-data dans un champ nommé file. La réponse contient un mediaId à utiliser à l'étape suivante.

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

Limites des médias

Les fichiers plus volumineux échouent avec 413 PAYLOAD_TOO_LARGE ; les autres formats avec 400 VALIDATION_ERROR. Les médias importés qui ne sont jamais utilisés dans un post peuvent être supprimés au bout d'un certain temps.

2. Publier le 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 peut contenir uniquement du texte, uniquement des médias, ou les deux. Chaque post est décompté du quota journalier de 50 posts par compte (quotas).

3. Modifier ou supprimer#

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

Vous ne pouvez modifier et supprimer que vos propres posts. Relisez-les avec GET /posts/{id} ou listez-les avec GET /me/posts (posts:read).

Publier une story#

Les stories utilisent le même processus d'import : importez le fichier avec POST /media, puis créez la story avec le mediaId. Scope stories:write, quota journalier de 20 stories.

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

Bonnes pratiques#

• Publiez des contenus que les gens ont envie de voir. Le remplissage répétitif ou automatisé est considéré comme du spam au sens des Conditions de l'API.
• Si POST /posts expire (timeout), vérifiez GET /me/posts avant de réessayer, afin d'éviter les doublons.
• Ne publiez que des médias dont vous détenez les droits.