Dokumentacja API — Pisma Szyte Na Miarę

curl "https://pismoszytenamiare.pl/api/v1/templates"

curl "https://pismoszytenamiare.pl/api/v1/templates?category=umowy"

{
  "status": "success",
  "count": 11,
  "data": [
    {
      "id": "umowa-najmu",
      "name": "Rental Agreement",
      "namePl": "Umowa najmu",
      "category": "umowy",
      "categoryPl": "Umowy",
      "description": "Standard rental/lease agreement",
      "descriptionPl": "Standardowa umowa najmu lokalu",
      "fieldCount": 13
    },
    {
      "id": "umowa-najmu-okazjonalny",
      "name": "Occasional Rental Agreement",
      "namePl": "Umowa najmu okazjonalnego",
      "category": "umowy",
      "categoryPl": "Umowy",
      "description": "Occasional rental agreement (Art. 19a)",
      "descriptionPl": "Umowa najmu okazjonalnego (Art. 19a)",
      "fieldCount": 16
    },
    {
      "id": "umowa-o-prace",
      "name": "Employment Contract",
      "namePl": "Umowa o pracę",
      "category": "umowy",
      "categoryPl": "Umowy",
      "description": "Standard employment contract",
      "descriptionPl": "Standardowa umowa o pracę",
      "fieldCount": 14
    }
  ]
}

curl "https://pismoszytenamiare.pl/api/v1/templates/umowa-najmu"

{
  "status": "success",
  "data": {
    "id": "umowa-najmu",
    "name": "Rental Agreement",
    "namePl": "Umowa najmu",
    "category": "umowy",
    "categoryPl": "Umowy",
    "description": "Standard rental/lease agreement",
    "descriptionPl": "Standardowa umowa najmu lokalu",
    "fields": [
      {
        "name": "landlordName",
        "label": "Imię i nazwisko wynajmującego",
        "type": "text",
        "required": true,
        "placeholder": "Jan Kowalski"
      },
      {
        "name": "landlordAddress",
        "label": "Adres wynajmującego",
        "type": "textarea",
        "required": true,
        "placeholder": "ul. Przykładowa 1, 00-001 Warszawa"
      },
      {
        "name": "landlordPesel",
        "label": "PESEL wynajmującego",
        "type": "text",
        "required": true,
        "placeholder": "12345678901"
      },
      {
        "name": "tenantName",
        "label": "Imię i nazwisko najemcy",
        "type": "text",
        "required": true,
        "placeholder": "Anna Nowak"
      },
      {
        "name": "propertyAddress",
        "label": "Adres lokalu",
        "type": "textarea",
        "required": true,
        "placeholder": "ul. Mieszkalna 5/3, 00-002 Warszawa"
      },
      {
        "name": "rentAmount",
        "label": "Kwota czynszu (PLN)",
        "type": "number",
        "required": true,
        "placeholder": "2500"
      },
      {
        "name": "startDate",
        "label": "Data rozpoczęcia",
        "type": "date",
        "required": true
      },
      {
        "name": "endDate",
        "label": "Data zakończenia",
        "type": "date",
        "required": false
      },
      {
        "name": "depositAmount",
        "label": "Kaucja (PLN)",
        "type": "number",
        "required": false,
        "defaultValue": "0"
      },
      {
        "name": "paymentDay",
        "label": "Dzień płatności",
        "type": "number",
        "required": true,
        "placeholder": "10",
        "defaultValue": "10"
      },
      {
        "name": "includeInventory",
        "label": "Dołącz protokół zdawczo-odbiorczy",
        "type": "checkbox",
        "required": false,
        "defaultValue": false
      },
      {
        "name": "inventoryItems",
        "label": "Elementy wyposażenia",
        "type": "textarea",
        "required": false,
        "condition": "includeInventory === true",
        "placeholder": "Lodówka, pralka, kuchenka..."
      },
      {
        "name": "additionalTerms",
        "label": "Dodatkowe postanowienia",
        "type": "textarea",
        "required": false
      }
    ]
  }
}

curl -X POST "https://pismoszytenamiare.pl/api/v1/documents/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "umowa-najmu",
    "data": {
      "landlordName": "Jan Kowalski",
      "landlordAddress": "ul. Przykładowa 1, 00-001 Warszawa",
      "landlordPesel": "85010112345",
      "tenantName": "Anna Nowak",
      "propertyAddress": "ul. Mieszkalna 5/3, 00-002 Warszawa",
      "rentAmount": 2500,
      "startDate": "2026-03-01",
      "endDate": "2027-02-28",
      "depositAmount": 5000,
      "paymentDay": 10,
      "includeInventory": false
    }
  }' --output umowa-najmu.pdf

{
  "status": "error",
  "error": "Brakujące wymagane pola",
  "message": "Następujące pola są wymagane: landlordName, tenantName, rentAmount",
  "missingFields": ["landlordName", "tenantName", "rentAmount"]
}

{
  "status": "error",
  "error": "Nie znaleziono szablonu",
  "message": "Szablon o identyfikatorze 'nieistniejacy-szablon' nie istnieje"
}

curl -X POST "https://pismoszytenamiare.pl/api/v1/documents/preview" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "umowa-najmu",
    "data": {
      "landlordName": "Jan Kowalski",
      "landlordAddress": "ul. Przykładowa 1, 00-001 Warszawa",
      "landlordPesel": "85010112345",
      "tenantName": "Anna Nowak",
      "propertyAddress": "ul. Mieszkalna 5/3, 00-002 Warszawa",
      "rentAmount": 2500,
      "startDate": "2026-03-01",
      "paymentDay": 10
    }
  }'

{
  "status": "success",
  "data": {
    "templateId": "umowa-najmu",
    "templateName": "Umowa najmu",
    "generatedAt": "2026-02-27T12:00:00.000Z",
    "sections": [
      {
        "title": "Nagłówek",
        "content": "UMOWA NAJMU LOKALU MIESZKALNEGO"
      },
      {
        "title": "Strony umowy",
        "content": "Zawarta w dniu 2026-03-01 pomiędzy:\n1. Jan Kowalski, zamieszkały/a: ul. Przykładowa 1, 00-001 Warszawa, PESEL: 85010112345 (Wynajmujący)\n2. Anna Nowak (Najemca)"
      },
      {
        "title": "Przedmiot umowy",
        "content": "Wynajmujący oddaje Najemcy do używania lokal mieszkalny położony pod adresem: ul. Mieszkalna 5/3, 00-002 Warszawa"
      },
      {
        "title": "Czynsz",
        "content": "Najemca zobowiązuje się płacić czynsz w wysokości 2500 PLN miesięcznie, do 10. dnia każdego miesiąca."
      }
    ]
  }
}

{
  "status": "success",
  "data": { ... },
  "count": 11
}

{
  "status": "error",
  "error": "Krótki opis błędu",
  "message": "Szczegółowy opis problemu z informacją jak go rozwiązać"
}

# Lista wszystkich szablonów
curl "https://pismoszytenamiare.pl/api/v1/templates"

# Szablony tylko z kategorii "umowy"
curl "https://pismoszytenamiare.pl/api/v1/templates?category=umowy"

# Pobierz schemat szablonu umowy najmu
curl "https://pismoszytenamiare.pl/api/v1/templates/umowa-najmu"

# Wygeneruj umowę najmu jako PDF
curl -X POST "https://pismoszytenamiare.pl/api/v1/documents/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "umowa-najmu",
    "data": {
      "landlordName": "Jan Kowalski",
      "landlordAddress": "ul. Przykładowa 1, 00-001 Warszawa",
      "landlordPesel": "85010112345",
      "tenantName": "Anna Nowak",
      "propertyAddress": "ul. Mieszkalna 5/3, 00-002 Warszawa",
      "rentAmount": 2500,
      "startDate": "2026-03-01",
      "endDate": "2027-02-28",
      "depositAmount": 5000,
      "paymentDay": 10,
      "includeInventory": false
    }
  }' --output umowa-najmu.pdf

# Podgląd dokumentu (JSON)
curl -X POST "https://pismoszytenamiare.pl/api/v1/documents/preview" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "wezwanie-do-zaplaty",
    "data": {
      "creditorName": "Firma ABC Sp. z o.o.",
      "debtorName": "XYZ Jan Nowak",
      "amount": 15000,
      "currency": "PLN",
      "dueDate": "2026-01-15",
      "paymentDeadline": "2026-03-15",
      "bankAccount": "PL 12 3456 7890 1234 5678 9012 3456"
    }
  }'

const BASE_URL = 'https://pismoszytenamiare.pl/api/v1';

// Lista wszystkich szablonów
const templatesRes = await fetch(`${BASE_URL}/templates`);
const templates = await templatesRes.json();
console.log(`Dostępne szablony: ${templates.count}`);

// Pobierz schemat szablonu
const schemaRes = await fetch(`${BASE_URL}/templates/umowa-najmu`);
const schema = await schemaRes.json();
console.log('Pola formularza:', schema.data.fields);

// Wygeneruj PDF umowy najmu
const pdfRes = await fetch(`${BASE_URL}/documents/generate`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    templateId: 'umowa-najmu',
    data: {
      landlordName: 'Jan Kowalski',
      landlordAddress: 'ul. Przykładowa 1, 00-001 Warszawa',
      landlordPesel: '85010112345',
      tenantName: 'Anna Nowak',
      propertyAddress: 'ul. Mieszkalna 5/3, 00-002 Warszawa',
      rentAmount: 2500,
      startDate: '2026-03-01',
      endDate: '2027-02-28',
      depositAmount: 5000,
      paymentDay: 10,
      includeInventory: false
    }
  })
});

// Zapisz PDF (Node.js)
const fs = await import('fs');
const buffer = Buffer.from(await pdfRes.arrayBuffer());
fs.writeFileSync('umowa-najmu.pdf', buffer);
console.log('PDF zapisany: umowa-najmu.pdf');

// Lub pobierz w przeglądarce
const blob = await pdfRes.blob();
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = 'umowa-najmu.pdf';
a.click();

// Podgląd dokumentu (JSON)
const previewRes = await fetch(`${BASE_URL}/documents/preview`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    templateId: 'umowa-najmu',
    data: {
      landlordName: 'Jan Kowalski',
      tenantName: 'Anna Nowak',
      propertyAddress: 'ul. Mieszkalna 5/3',
      rentAmount: 2500,
      startDate: '2026-03-01',
      paymentDay: 10
    }
  })
});
const preview = await previewRes.json();
console.log('Sekcje dokumentu:', preview.data.sections);

import requests

BASE_URL = "https://pismoszytenamiare.pl/api/v1"

# Lista wszystkich szablonów
response = requests.get(f"{BASE_URL}/templates")
templates = response.json()
print(f"Dostępne szablony: {templates['count']}")

# Filtruj szablony po kategorii
response = requests.get(f"{BASE_URL}/templates", params={"category": "umowy"})
umowy = response.json()
for t in umowy["data"]:
    print(f"  - {t['id']}: {t['namePl']}")

# Pobierz schemat szablonu
response = requests.get(f"{BASE_URL}/templates/umowa-najmu")
schema = response.json()
for field in schema["data"]["fields"]:
    req = "wymagane" if field["required"] else "opcjonalne"
    print(f"  {field['name']} ({field['type']}) - {req}")

# Wygeneruj PDF umowy najmu
response = requests.post(
    f"{BASE_URL}/documents/generate",
    json={
        "templateId": "umowa-najmu",
        "data": {
            "landlordName": "Jan Kowalski",
            "landlordAddress": "ul. Przykładowa 1, 00-001 Warszawa",
            "landlordPesel": "85010112345",
            "tenantName": "Anna Nowak",
            "propertyAddress": "ul. Mieszkalna 5/3, 00-002 Warszawa",
            "rentAmount": 2500,
            "startDate": "2026-03-01",
            "endDate": "2027-02-28",
            "depositAmount": 5000,
            "paymentDay": 10,
            "includeInventory": False,
        },
    },
)

# Zapisz PDF do pliku
with open("umowa-najmu.pdf", "wb") as f:
    f.write(response.content)
print("PDF zapisany: umowa-najmu.pdf")

# Podgląd dokumentu (JSON)
response = requests.post(
    f"{BASE_URL}/documents/preview",
    json={
        "templateId": "reklamacja",
        "data": {
            "complainantName": "Piotr Wiśniewski",
            "sellerName": "Sklep Elektroniczny Sp. z o.o.",
            "productName": "Laptop Model X200",
            "purchaseDate": "2026-01-10",
            "defectDescription": "Ekran migocze po 5 minutach użytkowania",
            "demand": "wymiana",
        },
    },
)
preview = response.json()
for section in preview["data"]["sections"]:
    print(f"\n--- {section['title']} ---")
    print(section["content"])

{
  "mcpServers": {
    "pismoszytenamiare": {
      "command": "npx",
      "args": ["-y", "pismoszytenamiare-mcp"]
    }
  }
}

Użytkownik: Wygeneruj umowę najmu. Wynajmujący: Jan Kowalski,
ul. Polna 5, Warszawa, PESEL 85010112345. Najemca: Anna Nowak.
Lokal: ul. Krótka 3/2, Warszawa. Czynsz: 3000 PLN, od 1 marca 2026.

Claude: Generuję umowę najmu z podanymi danymi...
[Używa narzędzia generate_document]
Umowa najmu została wygenerowana. Oto plik PDF do pobrania.