# Pageship

> Pageship ist ein deutscher Service, der Handwerkern, Dienstleistern, Künstlern und Privatpersonen
> eine professionelle Website ermöglicht — einfach, schnell und zu fairen Konditionen.
> Website-Erstellung einmalig 100 € (netto, zzgl. MwSt.), Hosting 5 € / Monat.
> Eine .de-Domain ist zum Launch kostenlos; weitere Domains ab 11 € / Jahr.
> Erst zahlen, wenn die kostenlose Vorschau gefällt — unverbindlich.

Pageship richtet sich an alle, die eine professionelle Online-Präsenz benötigen, aber weder
technisches Know-how noch ein großes Budget haben. Kunden beantworten einige Fragen zu ihrem
Unternehmen und ihren Wünschen — Pageship erstellt daraus eine moderne, schnelle Website.

Die Websites werden statisch generiert und über ein weltweites CDN ausgeliefert.
Betrieben wird Pageship von der RealMQ GmbH, Lindow 19, 15848 Friedland, Deutschland.

## Seiten

- [Startseite](https://pageship.de/): Übersicht, Leistungen, Preise und Newsletter-Anmeldung
- [Website konfigurieren](https://pageship.de/webseite-konfigurieren): Fragebogen für eine kostenlose, unverbindliche Website-Vorschau
- [Domains](https://pageship.de/domains): Domain-Endungen & Preise (.de, .com, .eu …); eine .de-Domain ist zum Launch kostenlos; je Domain ein 1-GB-E-Mail-Postfach, auf den Kunden registriert & jederzeit umziehbar
- [Impressum](https://pageship.de/impressum): Rechtliche Angaben gemäß § 5 TMG
- [Datenschutz](https://pageship.de/datenschutz): Datenschutzerklärung (keine Cookies, DSGVO-konform)

## API

Pageship bietet eine HTTP-API zum programmatischen Stellen von Website-Anfragen.
Eine Anfrage ist unverbindlich und kostenlos — es entsteht kein Kauf und keine Zahlung;
das Pageship-Team meldet sich anschließend mit einer kostenlosen Vorschau.
Die API eignet sich für KI-Agenten, Automatisierungen und Integrationen in eigene Systeme.
Authentifizierung ist nicht erforderlich.

- OpenAPI 3.1 Spec: `GET https://pageship.de/api/openapi.json`
- HTML-Dokumentation: `GET https://pageship.de/api/`

### Anfrage stellen

```http
POST https://pageship.de/api/website
Content-Type: application/json
```

Der Request-Body enthält folgende Objekte:

Feldnamen verwenden camelCase, Enum-Werte snake_case (z.B. "multi_page").
Pflicht ist serverseitig nur: contact (firstName, lastName, email) und questionnaire.basics.brandName.
Alle übrigen Felder sind optional und werden andernfalls akzeptiert.

**contact** (Pflicht) — Kontaktdaten des Anfragenden
- firstName (string, Pflicht)
- lastName (string, Pflicht)
- email (string, Pflicht) — Haupt-Kontaktadresse
- phone (string, optional)
- company (string, optional)

**billing** (optional) — Rechnungsadresse, falls vorab angegeben
- name (string, optional) — Rechnungsempfänger
- company (string, optional)
- street (string, optional)
- zip (string, optional)
- city (string, optional)
- country (string, optional) — ISO 3166-1 alpha-2, z.B. "DE"
- vatId (string, optional) — USt-IdNr. für B2B
- email (string, optional) — Rechnungs-E-Mail, falls abweichend

**questionnaire** (Pflicht) — Fragebogen zur Website

  *basics*
  - brandName (string, Pflicht) — Name der Marke oder des Unternehmens
  - offer (string, optional) — Kurzbeschreibung des Angebots, 1–2 Sätze
  - location (string, optional) — Standort
  - serviceArea (string, optional) — Einzugsgebiet
  - contactMethods (string[], optional) — Sichtbare Kontaktwege: "phone", "email", "contact_form", "whatsapp"
  - hasLogo (boolean, optional) — Logo vorhanden?
  - brandColors (string[], optional) — Hex-Farbwerte, z.B. ["#2d6a4f", "#ffffff"]

  *goals*
  - primaryGoal (string, optional) — Hauptziel der Website, z.B. "Neue Kunden gewinnen"
  - primaryCta (string, optional) — Gewünschte erste Aktion der Besucher
  - targetAudience (string, optional) — Beschreibung der Zielgruppe

  *pages*
  - type (string, optional) — "one_pager" oder "multi_page"
  - pages (string[], optional) — Gewünschte Unterseiten bei multi_page
  - contentStatus.textsAvailable (boolean, optional)
  - contentStatus.imagesAvailable (boolean, optional)
  - contentStatus.imageCount (integer, optional)

  *design*
  - tone (string, optional) — Tonalität, z.B. "seriös, modern, freundlich"
  - referenceUrls (string[], optional) — Stilreferenz-URLs
  - styleNotes (string, optional) — Weitere Designhinweise

  *features*
  - contactForm (boolean, optional)
  - newsletter (boolean, optional)
  - booking (boolean, optional)
  - shop (boolean, optional)
  - blog (boolean, optional)
  - gallery (boolean, optional) — Bildergalerie / Portfolio-Bereich
  - languages (string[], optional) — ISO 639-1, z.B. ["de"]
  - hasPrivacyPolicy (boolean, optional)
  - hasTerms (boolean, optional)

  *imprint* — Angaben fürs Impressum (TMG § 5); Anschrift + vatId stammen aus billing
  - legalForm (string, optional) — Rechtsform, z.B. Einzelunternehmen, GmbH, UG
  - representative (string, optional) — Vertretungsberechtigte(r) / Geschäftsführer
  - registerCourt (string, optional) — Registergericht
  - registerNumber (string, optional) — Handelsregisternummer (HRB/HRA)

**domain** (optional)
- requested (string) — Wunschdomain, z.B. "mein-betrieb.de"
- suggest (boolean) — PageShip soll Domains vorschlagen
- tlds (string[]) — Bevorzugte TLDs, Standard: [".de"]

**attachments** (optional) — Dateien werden nicht direkt übertragen, sondern über Pre-signed URLs hochgeladen
- logo — { filename, mimeType }
- photos — Array, max. 20, Bildformate
- videos — Array, max. 5, Videoformate
- docs — Array, max. 10, nur application/pdf

**notes** (string, optional) — Freitext für Sonderwünsche, max. 2000 Zeichen

### Response 201 Created

```json
{
  "id": "ws_01j9k2m3n4p5q6r7s8t9",
  "status": "pending",
  "createdAt": "2026-04-27T10:00:00Z",
  "uploadUrls": {
    "logo": { "filename": "logo.png", "url": "https://...", "method": "PUT", "expiresAt": "..." },
    "photos": [...]
  }
}
```

uploadUrls ist nur vorhanden, wenn attachments im Request angegeben wurde.
Dateien werden per PUT direkt an die signierten URLs übertragen (Content-Type muss dem mimeType entsprechen).
Upload-URLs sind 24 Stunden gültig.

### Fehler 422 Unprocessable Entity

```json
{ "error": "validation_failed", "fields": { "contact.email": "Required field missing" } }
```

## Optional

- [Sitemap](https://pageship.de/sitemap.xml)
- [OpenAPI Spec](https://pageship.de/api/openapi.json)