OpenAPI Spezifikation

# OpenAPI Generator installieren
npm install -g @openapitools/openapi-generator-cli

# TypeScript SDK generieren
openapi-generator-cli generate \
  -i steuermappe-api-v1.yaml \
  -g typescript-axios \
  -o ./src/api-client \
  --additional-properties=supportsES6=true,npmName=@yourorg/steuermappe-client

# SDK verwenden
cd ./src/api-client && npm install && npm run build

import { Configuration, BatchesApi } from '@yourorg/steuermappe-client';

const config = new Configuration({
  basePath: 'https://api.steuermappe-pro.de/v1',
  accessToken: 'your-oauth-token'
});

const batchesApi = new BatchesApi(config);

// Typsicherer API-Aufruf
const batch = await batchesApi.createBatch({
  projectId: 'proj_123',
  documents: files,
  mandantId: 'mand_456' // Optional
});

console.log(`Batch erstellt: ${batch.data.id}`);

# OpenAPI Generator mit Docker (empfohlen)
docker run --rm -v "${PWD}:/local" openapitools/openapi-generator-cli generate \
  -i /local/steuermappe-api-v1.yaml \
  -g python \
  -o /local/python-client \
  --additional-properties=packageName=steuermappe_client,projectName=steuermappe-client

# Oder mit pip
pip install openapi-generator-cli
openapi-generator-cli generate -i steuermappe-api-v1.yaml -g python -o ./python-client

# SDK installieren
cd python-client && pip install .

from steuermappe_client import ApiClient, Configuration, BatchesApi
from steuermappe_client.models import CreateBatchRequest

# Konfiguration
config = Configuration(
    host="https://api.steuermappe-pro.de/v1",
    access_token="your-oauth-token"
)

# API-Client erstellen
with ApiClient(config) as api_client:
    batches_api = BatchesApi(api_client)

    # Batch erstellen (mit Type Hints)
    request = CreateBatchRequest(
        project_id="proj_123",
        documents=files,
        mandant_id="mand_456"  # Optional
    )

    batch = batches_api.create_batch(request)
    print(f"Batch erstellt: {batch.id}")

# Java SDK mit Maven-Build generieren
openapi-generator-cli generate \
  -i steuermappe-api-v1.yaml \
  -g java \
  -o ./java-client \
  --additional-properties=\
library=resttemplate,\
groupId=com.yourorg,\
artifactId=steuermappe-client,\
apiPackage=com.yourorg.steuermappe.api,\
modelPackage=com.yourorg.steuermappe.model

# Build
cd java-client && mvn clean install

import com.yourorg.steuermappe.api.BatchesApi;
import com.yourorg.steuermappe.model.CreateBatchRequest;
import com.yourorg.steuermappe.model.Batch;

// API-Client konfigurieren
ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.steuermappe-pro.de/v1");
apiClient.setAccessToken("your-oauth-token");

BatchesApi batchesApi = new BatchesApi(apiClient);

// Batch erstellen
CreateBatchRequest request = new CreateBatchRequest()
    .projectId("proj_123")
    .documents(files)
    .mandantId("mand_456"); // Optional

Batch batch = batchesApi.createBatch(request);
System.out.println("Batch erstellt: " + batch.getId());