Comment automatiser Confluence via son API REST en 2026

mkdir confluence-bot
cd confluence-bot
npm init -y
npm install axios dotenv typescript ts-node @types/node
npm install -D @types/axios
npx tsc --init
mkdir src

{
  "name": "confluence-bot",
  "version": "1.0.0",
  "main": "src/index.ts",
  "scripts": {
    "start": "ts-node src/index.ts",
    "dev": "ts-node --watch src/index.ts"
  },
  "dependencies": {
    "axios": "^1.7.2",
    "dotenv": "^16.4.5",
    "typescript": "^5.5.3",
    "ts-node": "^10.9.2",
    "@types/node": "^22.3.0"
  },
  "devDependencies": {
    "@types/axios": "^0.14.0"
  }
}

CONFLUENCE_BASE_URL=https://votre-site.atlassian.net/wiki
CONFLUENCE_EMAIL=votre.email@entreprise.com
CONFLUENCE_API_TOKEN=ATATT3x...VotreTokenComplet
SPACE_KEY=MYSPACE

import axios, { AxiosInstance, AxiosError } from 'axios';
import dotenv from 'dotenv';

dotenv.config();

const config = {
  baseURL: process.env.CONFLUENCE_BASE_URL + '/rest/api',
  auth: {
    username: process.env.CONFLUENCE_EMAIL!,
    password: process.env.CONFLUENCE_API_TOKEN!
  },
  headers: { 'Accept': 'application/json', 'Content-Type': 'application/json' }
};

export const client: AxiosInstance = axios.create(config);

client.interceptors.response.use(
  (response) => response,
  (error: AxiosError) => {
    if (error.response?.status === 429) {
      console.error('Rate limit atteinte, attendez 1min');
      throw error;
    }
    console.error('Erreur API:', error.response?.data || error.message);
    throw error;
  }
);

export async function listSpaces(): Promise<any[]> {
  const res = await client.get('/space');
  return res.data.results;
}

// Test
(async () => {
  try {
    const spaces = await listSpaces();
    console.log('Spaces:', spaces.map((s: any) => ({ key: s.key, name: s.name })));
  } catch (err) {
    console.error('Échec:', err);
  }
})();

import { client } from './confluenceClient';

export async function createSpace(name: string, key: string): Promise<any> {
  const payload = {
    type: 'global',
    status: 'current',
    name,
    key,
    description: { plain: { value: 'Space créé via API en 2026', representation: 'plain' } }
  };
  const res = await client.post('/space', payload);
  console.log('Space créé:', res.data);
  return res.data;
}

// Usage
(async () => {
  await createSpace('Mon Bot Space', 'BOTSPACE');
})();

import { client } from './confluenceClient';

export async function createPage(spaceKey: string, title: string, bodyHtml: string, parentId?: string): Promise<any> {
  const payload = {
    type: 'page',
    status: 'current',
    space: { key: spaceKey },
    title,
    body: {
      storage: {
        value: bodyHtml,
        representation: 'storage'
      }
    },
    ...(parentId && { parent: { id: parentId } })
  };
  const res = await client.post('/content', payload);
  console.log('Page créée ID:', res.data.id);
  return res.data;
}

export async function updatePage(pageId: string, version: number, bodyHtml: string): Promise<any> {
  const payload = {
    id: pageId,
    type: 'page',
    title: 'Titre mis à jour',
    version: { number: version + 1 },
    body: {
      storage: { value: bodyHtml, representation: 'storage' }
    }
  };
  const res = await client.put(`/content/${pageId}`, payload);
  console.log('Page updatée, nouvelle version:', res.data.version.number);
  return res.data;
}

// Usage exemple
(async () => {
  const page = await createPage('BOTSPACE', 'Page Bot Test', '<h1>Hello 2026!</h1><p>Automatisé.</p>');
  await updatePage(page.id, page.version.number, '<h1>Mis à jour!</h1><p>Version 2.</p>');
})();

import { client } from './confluenceClient';
import fs from 'fs';

export async function uploadAttachment(pageId: string, filePath: string): Promise<any> {
  if (!fs.existsSync(filePath)) throw new Error('Fichier non trouvé');
  const formData = new FormData();
  formData.append('file', fs.createReadStream(filePath), { filename: filePath.split('/').pop() });
  formData.append('comment', 'Upload auto 2026');

  const res = await client.post(`/content/${pageId}/child/attachment`, formData, {
    headers: formData.getHeaders()
  });
  console.log('Attachment uploadé:', res.data);
  return res.data;
}

// Ajoutez npm install form-data @types/form-data pour FormData polyfill si besoin
// Usage
// await uploadAttachment('123456', './rapport.pdf');

import { client } from './confluenceClient';

export async function searchPages(cql: string, start = 0, limit = 25): Promise<any> {
  const params = new URLSearchParams({ cql, start: start.toString(), limit: limit.toString() });
  const res = await client.get(`/content/search?${params.toString()}`);
  console.log(`Résultats (${res.data.size}/${res.data.totalSize}):`, res.data.results.map((p: any) => ({ id: p.id, title: p.title }))) ;
  return res.data;
}

// Usage avancées
(async () => {
  await searchPages('type=page and space=BOTSPACE and created >= -1d');
  await searchPages('type=page and text ~ "erreur"', 0, 100);
})();