Artikel für Unternehmen veröffentlichen

Voraussetzung: Sie benötigen einen API-Token und sollten sich mit der Artikel-Erstellung vertraut gemacht haben.

Überblick

Benutzer können Artikel nicht nur für sich selbst, sondern auch für Unternehmen veröffentlichen, bei denen sie Administrator-Rechte besitzen. Das Unternehmen wird dann als Autor des Artikels angezeigt.

Voraussetzungen

Um einen Artikel für ein Unternehmen zu veröffentlichen, müssen folgende Bedingungen erfüllt sein:

1. Sie sind Mitglied des Unternehmens
2. Ihre Rolle im Unternehmen ist "admin" (Administrator)
3. Sie haben einen gültigen API-Token

Unternehmen abrufen

API-Endpunkt

GET /api/companies

Authentifizierung: Bearer Token erforderlich

Dieser Endpunkt gibt alle Unternehmen zurück, zu denen Sie gehören:

Response Felder

curl -X GET https://ihre-domain.de/api/companies \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Accept: application/json"

Antwort-Beispiel

{
  "data": [
    {
      "id": 5,
      "name": "Mustermann Immobilien GmbH",
      "profile_role": "admin"
    },
    {
      "id": 12,
      "name": "Stadtwerke Wohnbau AG",
      "profile_role": "member"
    },
    {
      "id": 18,
      "name": "Premium Estates GmbH",
      "profile_role": "admin"
    }
  ]
}

Wichtig: Nur Unternehmen mit "profile_role": "admin" können für Artikel-Veröffentlichungen verwendet werden!

Artikel mit Unternehmens-Autor erstellen

Query-Parameter verwenden

Um einen Artikel für ein Unternehmen zu veröffentlichen, fügen Sie den Query-Parameter company_id zur URL hinzu:

POST /api/articles?company_id=5

Company ID Parameter

Wichtig: Alle regulären Artikel-Felder (title, content, categories, images) bleiben unverändert. Siehe Artikel erstellen für vollständige Feld-Referenz.

Vollständiges Beispiel

cURL

curl -X POST "https://ihre-domain.de/api/articles?company_id=5" \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "title": "Mustermann Immobilien erweitert Portfolio um nachhaltiger Wohnprojekte",
    "content": "<h2>Nachhaltige Wohnkonzepte</h2><p>Die Mustermann Immobilien GmbH setzt verstärkt auf nachhaltige Bauprojekte mit über 800 Zeichen an detaillierten Informationen zu unseren neuen Entwicklungen. Unsere Vision umfasst energieeffiziente Gebäude mit modernster Technik, die sowohl ökologisch als auch ökonomisch sinnvoll sind. Mit der Integration von Photovoltaik-Anlagen, Wärmepumpen und intelligenten Heizsystemen schaffen wir Lebensräume für die Zukunft. Die Projekte befinden sich in erstklassigen Lagen mit optimaler Verkehrsanbindung und umfassender Infrastruktur. Familien finden hier ein Zuhause, das höchsten Ansprüchen an Wohnqualität und Nachhaltigkeit gerecht wird. Unser erfahrenes Team begleitet Sie von der ersten Beratung bis zum Einzug.</p><h3>Unsere Leistungen</h3><ul><li>Energieeffiziente Bauweise nach KfW-Standard</li><li>Moderne Smart-Home-Integration</li><li>Nachhaltige Materialauswahl</li></ul>",
    "excerpt": "Mustermann Immobilien setzt neue Maßstäbe im nachhaltigen Wohnungsbau mit innovativen Konzepten",
    "publish_at": "2024-03-20T09:00:00Z",
    "categories": [1, 4],
    "images": [
      {
        "url": "https://example.com/company-images/nachhaltig-wohnen.jpg",
        "alt": "Nachhaltige Wohnanlage mit Photovoltaik und Grünflächen"
      }
    ]
  }'

JavaScript (fetch)

const companyId = 5; // ID des Unternehmens

const articleData = {
  title: "Mustermann Immobilien erweitert Portfolio um nachhaltige Wohnprojekte",
  content: "<h2>Nachhaltige Wohnkonzepte</h2>...",
  excerpt: "Mustermann Immobilien setzt neue Maßstäbe...",
  publish_at: "2024-03-20T09:00:00Z",
  categories: [1, 4],
  images: [
    {
      url: "https://example.com/company-images/nachhaltig-wohnen.jpg",
      alt: "Nachhaltige Wohnanlage mit Photovoltaik und Grünflächen"
    }
  ]
};

fetch(`https://ihre-domain.de/api/articles?company_id=${companyId}`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + apiToken,
    'Content-Type': 'application/json',
    'Accept': 'application/json'
  },
  body: JSON.stringify(articleData)
})
.then(response => response.json())
.then(data => {
  if (data.data) {
    console.log('Artikel für Unternehmen erstellt:', data.data);
  } else {
    console.error('Fehler:', data);
  }
});

PHP

$companyId = 5;

$articleData = [
    'title' => 'Mustermann Immobilien erweitert Portfolio um nachhaltige Wohnprojekte',
    'content' => '<h2>Nachhaltige Wohnkonzepte</h2>...',
    'excerpt' => 'Mustermann Immobilien setzt neue Maßstäbe...',
    'publish_at' => '2024-03-20T09:00:00Z',
    'categories' => [1, 4],
    'images' => [
        [
            'url' => 'https://example.com/company-images/nachhaltig-wohnen.jpg',
            'alt' => 'Nachhaltige Wohnanlage mit Photovoltaik und Grünflächen'
        ]
    ]
];

$url = 'https://ihre-domain.de/api/articles?company_id=' . $companyId;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiToken,
    'Content-Type: application/json',
    'Accept: application/json'
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($articleData));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 201) {
    $article = json_decode($response, true);
    echo "Unternehmens-Artikel erstellt: " . $article['data']['title'];
} else {
    $error = json_decode($response, true);
    echo "Fehler: " . ($error['message'] ?? 'Unbekannter Fehler');
}

Erfolgreiche Antwort

Wenn der Artikel erfolgreich für das Unternehmen erstellt wurde:

{
  "data": {
    "id": 89,
    "title": "Mustermann Immobilien erweitert Portfolio um nachhaltige Wohnprojekte",
    "content": "<h2>Nachhaltige Wohnkonzepte</h2>...",
    "excerpt": "Mustermann Immobilien setzt neue Maßstäbe...",
    "link": "https://ihre-domain.de/artikel/mustermann-immobilien-nachhaltige-wohnprojekte",
    "publish_at": "2024-03-20T09:00:00.000000Z",
    "created_at": "2024-03-15T11:30:00.000000Z",
    "updated_at": "2024-03-15T11:30:00.000000Z",
    "author": {
      "id": 5,
      "name": "Mustermann Immobilien GmbH"
    },
    "categories": [...],
    "images": [...]
  },
  "message": "Article created successfully"
}

Beachten Sie: Das author Objekt enthält jetzt das Unternehmen, nicht den Benutzer!

Fehlerbehandlung

Keine Admin-Rechte (422 Validation Error)

{
  "message": "Sie müssen Administrator dieser Firma sein, um einen Artikel für sie zu erstellen.",
  "errors": {
    "company_id": [
      "Sie müssen Administrator dieser Firma sein, um einen Artikel für sie zu erstellen."
    ]
  }
}

Ursache: Sie haben keine Admin-Rechte (profile_role !== "admin") für dieses Unternehmen.

Lösung:

• Wählen Sie ein anderes Unternehmen, bei dem Sie Admin sind
• Oder lassen Sie company_id weg, um als persönlicher Autor zu veröffentlichen

Unternehmen existiert nicht (422 Validation Error)

{
  "message": "Die ausgewählte Firma existiert nicht.",
  "errors": {
    "company_id": [
      "Die ausgewählte Firma existiert nicht."
    ]
  }
}

Ursache: Die angegebene company_id existiert nicht in der Datenbank.

Lösung: Rufen Sie /api/companies auf, um gültige Unternehmens-IDs zu erhalten.

Nicht Mitglied des Unternehmens (422 Validation Error)

{
  "message": "Sie müssen Administrator dieser Firma sein, um einen Artikel für sie zu erstellen.",
  "errors": {
    "company_id": [
      "Sie müssen Administrator dieser Firma sein, um einen Artikel für sie zu erstellen."
    ]
  }
}

Ursache: Sie gehören nicht zu diesem Unternehmen.

Lösung: Verwenden Sie nur Unternehmen aus Ihrer /api/companies Liste.

Workflow-Beispiel

1. Unternehmen mit Admin-Rechten finden

// Unternehmen abrufen
const response = await fetch('https://ihre-domain.de/api/companies', {
  headers: {
    'Authorization': 'Bearer ' + apiToken,
    'Accept': 'application/json'
  }
});

const companies = await response.json();

// Nur Admin-Unternehmen filtern
const adminCompanies = companies.data.filter(c => c.profile_role === 'admin');

console.log('Verfügbare Unternehmen:', adminCompanies);
// [
//   { id: 5, name: "Mustermann Immobilien GmbH", profile_role: "admin" },
//   { id: 18, name: "Premium Estates GmbH", profile_role: "admin" }
// ]

2. Benutzer Unternehmen auswählen lassen

// HTML Select-Element befüllen
const companySelect = document.getElementById('company-select');
companySelect.innerHTML = '<option value="">Als persönlicher Autor</option>';

adminCompanies.forEach(company => {
  const option = document.createElement('option');
  option.value = company.id;
  option.textContent = company.name;
  companySelect.appendChild(option);
});

3. Artikel mit ausgewähltem Unternehmen erstellen

async function createArticle(articleData, companyId = null) {
  let url = 'https://ihre-domain.de/api/articles';

  // Falls Unternehmens-ID angegeben, als Query-Parameter anhängen
  if (companyId) {
    url += `?company_id=${companyId}`;
  }

  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer ' + apiToken,
      'Content-Type': 'application/json',
      'Accept': 'application/json'
    },
    body: JSON.stringify(articleData)
  });

  if (response.ok) {
    const result = await response.json();
    console.log('Artikel erstellt:', result.data);
    return result.data;
  } else {
    const error = await response.json();
    console.error('Fehler beim Erstellen:', error);
    throw error;
  }
}

// Verwendung
const selectedCompanyId = companySelect.value || null;
createArticle(articleData, selectedCompanyId);

Wichtige Hinweise

Autor kann nicht geändert werden

Einmal erstellte Artikel behalten ihren Autor. Sie können den Autor nicht nachträglich ändern:

• Ein persönlicher Artikel bleibt persönlich
• Ein Unternehmens-Artikel bleibt beim Unternehmen

Tipp: Überlegen Sie vor der Erstellung, wer als Autor angezeigt werden soll.

Berechtigungen beim Bearbeiten

Artikel können nur vom Autor bearbeitet werden:

• Persönliche Artikel: Nur Sie können sie bearbeiten
• Unternehmens-Artikel: Nur Admins dieses Unternehmens können sie bearbeiten

Query-Parameter vs. Request-Body

Wichtig: Die company_id wird als Query-Parameter übergeben, nicht im Request-Body!

✅ Richtig:

POST /api/articles?company_id=5
Body: { title, content, ... }

❌ Falsch:

POST /api/articles
Body: { company_id: 5, title, content, ... }

Best Practices

1. Unternehmen cachen

Laden Sie die Unternehmensliste einmal und cachen Sie sie:

let cachedCompanies = null;

async function getAdminCompanies() {
  if (cachedCompanies) return cachedCompanies;

  const response = await fetch('/api/companies', {
    headers: { 'Authorization': 'Bearer ' + apiToken }
  });

  const data = await response.json();
  cachedCompanies = data.data.filter(c => c.profile_role === 'admin');

  return cachedCompanies;
}

2. Validierung vor API-Call

Prüfen Sie Admin-Rechte, bevor Sie die API aufrufen:

async function validateCompanyAccess(companyId) {
  const companies = await getAdminCompanies();
  return companies.some(c => c.id === companyId);
}

if (companyId && !await validateCompanyAccess(companyId)) {
  alert('Sie haben keine Admin-Rechte für dieses Unternehmen');
  return;
}

3. Benutzerfreundliche Fehlerbehandlung

try {
  const article = await createArticle(articleData, companyId);
  showSuccess('Artikel erfolgreich erstellt!');
} catch (error) {
  if (error.errors?.company_id) {
    showError('Keine Berechtigung für dieses Unternehmen');
  } else {
    showError('Fehler beim Erstellen des Artikels');
  }
}

Zusammenfassung

1. Unternehmen abrufen mit /api/companies
2. Admin-Unternehmen filtern (profile_role === "admin")
3. Query-Parameter verwenden ?company_id=X bei der Artikel-Erstellung
4. Fehler abfangen und benutzerfreundlich behandeln

Mit dieser Funktion können Sie Artikel sowohl persönlich als auch im Namen Ihrer Unternehmen veröffentlichen!

Weitere Dokumentation

• API-Token erstellen und verwenden
• Kategorie-IDs abrufen
• Artikel über die API erstellen