How to Integrate Replit with TYPO3

1# Install EXT:headless via Composer on the TYPO3 server
2# (Run this on the TYPO3 server, not in Replit)
3composer require wirl-pl/headless
4
5# Flush TYPO3 caches after installation
6./vendor/bin/typo3 cache:flush

1// check-typo3-secrets.js
2const required = ['TYPO3_API_TOKEN', 'TYPO3_BASE_URL', 'TYPO3_API_PATH'];
3for (const key of required) {
4  if (!process.env[key]) {
5    throw new Error(`Missing secret: ${key}. Set it in Replit Secrets (lock icon 🔒).`);
6  }
7}
8console.log('TYPO3 config OK.');
9console.log('Base URL:', process.env.TYPO3_BASE_URL);
10console.log('API path:', process.env.TYPO3_API_PATH);

1// typo3.js — TYPO3 Headless API integration for Node.js on Replit
2const axios = require('axios');
3const express = require('express');
4
5const app = express();
6app.use(express.json());
7
8const BASE_URL = process.env.TYPO3_BASE_URL;
9const API_PATH = process.env.TYPO3_API_PATH;
10const API_TOKEN = process.env.TYPO3_API_TOKEN;
11
12const typo3Api = axios.create({
13  baseURL: BASE_URL,
14  headers: {
15    'X-Auth-Token': API_TOKEN,  // EXT:headless v3+ uses this header
16    // Some versions use: 'Authorization': `Bearer ${API_TOKEN}`
17    'Accept': 'application/json'
18  }
19});
20
21// Get page content by TYPO3 page UID
22app.get('/api/page/:pageId', async (req, res) => {
23  const pageId = parseInt(req.params.pageId);
24  if (!pageId) return res.status(400).json({ error: 'Valid page ID required' });
25  
26  try {
27    // EXT:headless endpoint format — may vary by version
28    const response = await typo3Api.get(`${API_PATH}`, {
29      params: { id: pageId, type: 834 }  // type=834 is EXT:headless JSON typeNum
30    });
31    
32    const data = response.data;
33    
34    // Extract page metadata and content elements
35    const page = {
36      id: data.page?.id || pageId,
37      title: data.page?.title,
38      description: data.page?.description,
39      slug: data.page?.slug,
40      seo: data.seo || {},
41      // colPos0 is the main content column in most TYPO3 layouts
42      content: data.content?.colPos0 || data.content?.main || []
43    };
44    
45    res.json(page);
46  } catch (err) {
47    res.status(err.response?.status || 500).json({ error: err.message });
48  }
49});
50
51// Get site navigation / page tree
52app.get('/api/navigation', async (req, res) => {
53  const { rootPageId = 1, levels = 2 } = req.query;
54  try {
55    const response = await typo3Api.get(`${API_PATH}`, {
56      params: {
57        id: rootPageId,
58        type: 834,
59        tx_headless_request: JSON.stringify({ navigation: true, levels })
60      }
61    });
62    res.json({ navigation: response.data.navigation || [] });
63  } catch (err) {
64    res.status(err.response?.status || 500).json({ error: err.message });
65  }
66});
67
68// Get list of content elements from a page filtered by type
69app.get('/api/page/:pageId/content', async (req, res) => {
70  const { pageId } = req.params;
71  const { type: filterType } = req.query;
72  try {
73    const response = await typo3Api.get(`${API_PATH}`, {
74      params: { id: pageId, type: 834 }
75    });
76    
77    const allContent = [
78      ...(response.data.content?.colPos0 || []),
79      ...(response.data.content?.colPos1 || [])
80    ];
81    
82    const filtered = filterType
83      ? allContent.filter(el => el.type === filterType)
84      : allContent;
85    
86    res.json({ pageId, content: filtered, count: filtered.length });
87  } catch (err) {
88    res.status(err.response?.status || 500).json({ error: err.message });
89  }
90});
91
92app.listen(3000, '0.0.0.0', () => console.log('TYPO3 headless server running on port 3000'));

1# typo3_api.py — TYPO3 Headless API for Python on Replit
2import os
3import requests
4from flask import Flask, request, jsonify
5
6BASE_URL = os.environ['TYPO3_BASE_URL']
7API_PATH = os.environ['TYPO3_API_PATH']
8API_TOKEN = os.environ['TYPO3_API_TOKEN']
9
10session = requests.Session()
11session.headers.update({
12    'X-Auth-Token': API_TOKEN,
13    'Accept': 'application/json'
14})
15
16app = Flask(__name__)
17
18def get_page_content(page_id: int) -> dict:
19    """Fetch TYPO3 page content by page UID."""
20    response = session.get(
21        f'{BASE_URL}{API_PATH}',
22        params={'id': page_id, 'type': 834}
23    )
24    response.raise_for_status()
25    return response.json()
26
27def extract_content_elements(data: dict) -> list:
28    """Flatten all colPos content elements from a TYPO3 page response."""
29    content = data.get('content', {})
30    elements = []
31    for col_key in sorted(content.keys()):  # colPos0, colPos1, etc.
32        elements.extend(content[col_key])
33    return elements
34
35@app.route('/api/page/<int:page_id>')
36def get_page(page_id):
37    try:
38        data = get_page_content(page_id)
39        return jsonify({
40            'id': page_id,
41            'title': data.get('page', {}).get('title'),
42            'description': data.get('page', {}).get('description'),
43            'slug': data.get('page', {}).get('slug'),
44            'content': extract_content_elements(data),
45            'seo': data.get('seo', {})
46        })
47    except requests.HTTPError as e:
48        return jsonify({'error': str(e)}), e.response.status_code
49
50@app.route('/api/pages/crawl')
51def crawl_pages():
52    """Crawl multiple TYPO3 pages and return their titles."""
53    start = int(request.args.get('start', 1))
54    end = int(request.args.get('end', 20))
55    results = []
56    for pid in range(start, min(end + 1, start + 50)):  # Max 50 pages per request
57        try:
58            data = get_page_content(pid)
59            page = data.get('page', {})
60            if page.get('title'):  # Skip non-existent pages
61                results.append({'id': pid, 'title': page['title'], 'slug': page.get('slug')})
62        except Exception:
63            pass  # Skip pages that return errors
64    return jsonify({'pages': results, 'count': len(results)})
65
66if __name__ == '__main__':
67    app.run(host='0.0.0.0', port=3000)