Die Spreadsheet-API-Revolution: Warum Entwickler keine Datei-Uploads mehr verwenden

Das Problem mit dem Parsen von Excel-Dateien

Du suchst den Grund, warum dein Excel-Parser andere Ergebnisse liefert als die Arbeitsmappe selbst. Der Fachbereich hat sein Modell aktualisiert und Logik ergänzt, die dein Code nicht kennt. Dein Code ist jetzt falsch, und niemand hat Bescheid gesagt.

Die versteckten Kosten des Parsens

1. Ein Parser liest Werte, er rechnet nicht

// Was wir schreiben
const workbook = XLSX.readFile('pricing.xlsx');
const price = workbook.Sheets['Quote']['B15'].v;

// Was wir bekommen: den Wert, der beim letzten Speichern in der Datei stand.
// Ändere eine Eingabe, und nichts wird neu berechnet:
// - Formeln, die auf andere Zellen verweisen
// - Verweise in andere Blätter
// - definierte Namen

Für ein neues Ergebnis zu neuen Eingaben muss dein Code die Formeln selbst neu berechnen. Das heißt: sie nachbauen.

2. Der Wartungsaufwand

  • Jede Formel, die zählt, wird im Code nachgebaut.
  • Jede Änderung in der Arbeitsmappe muss ein zweites Mal gemacht werden.
  • Abweichungen fallen spät auf, meist wenn ein Kunde eine falsche Zahl bemerkt.

Der API-Ansatz

Statt die Datei zu parsen, lässt du die Arbeitsmappe rechnen:

const url =
  'https://spreadapi.io/api/v1/services/{serviceId}/execute?flatten=true';

const response = await fetch(url, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    inputs: { quantity: 100, customerType: 'enterprise' }
  })
});

const data = await response.json();
const price = data.result.finalPrice;

Mit SpreadAPI importierst du die Arbeitsmappe einmal, legst fest, welche Zellen Eingaben und welche Ausgaben sind, und veröffentlichst sie als Service. Jeder Aufruf setzt die Eingaben, berechnet die Arbeitsmappe auf dem Server und gibt die Ausgaben zurück.

Warum Entwickler wechseln

1. Kein Parsen

Deine Integration ist ein HTTP-Aufruf. Auf deiner Seite gibt es keine Dateiverarbeitung und keinen Formelcode.

2. Die Geschäftslogik bleibt in Excel

  • Der Fachbereich ändert die Preise in Excel.
  • Jemand importiert die neue Arbeitsmappe in den Service und veröffentlicht ihn. Eingaben, Ausgaben und Tokens bleiben erhalten.
  • Ab dem nächsten Aufruf bekommt jeder Aufrufer die neue Logik. Ein Code-Release ist nicht nötig.

3. Die Arbeitsmappe wird nicht herausgegeben

Aufrufer senden Eingaben und bekommen Ausgaben. Die Arbeitsmappe und ihre Formeln sehen sie nicht. Ein Service ist öffentlich oder durch Tokens geschützt, die du erstellst und widerrufst. Siehe Tokens und Zugriff.

Technische Umsetzung

Wie es funktioniert

  1. Importieren: die Excel-Arbeitsmappe, im Browser
  2. Festlegen: Eingabe- und Ausgabezellen
  3. Veröffentlichen: der Service bekommt seine Adresse
  4. Aufrufen: GET oder POST, JSON zurück

Beispiel: Kreditrechner

const url = 'https://spreadapi.io/api/v1/services/{serviceId}/execute';

const response = await fetch(url, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    inputs: { principal: 500000, rate: 0.045, years: 30 }
  })
});

const data = await response.json();
// {
//   "service": { ... },
//   "inputs":  [ { "name": "principal", "value": 500000 }, ... ],
//   "outputs": [
//     { "name": "monthlyPayment", "title": "Monatsrate",
//       "value": 2533.43 }
//   ],
//   "metadata": { "executionTime": 12, "totalTime": 15, ... }
// }

outputs ist eine Liste. Suche einen Eintrag über seinen name, oder hänge flatten=true an die Adresse und lies result.monthlyPayment. Prozentwerte werden als Dezimalzahl gesendet: 0.045 für 4,5 %. Die Einzelheiten stehen in Einen Service über die API aufrufen und Die API-Antwort.

Und die Antwortzeit?

Wir haben unseren öffentlichen Demo-Angebotsrechner gemessen, eine Arbeitsmappe mit vier Blättern: Eine Berechnung dauerte auf dem Server etwa 20 ms, der ganze Weg hin und zurück von einem Client in Deutschland im Median 97 ms. Der erste Aufruf nach einer Pause brauchte 213 ms. Diese Zahlen gelten nur für diese Arbeitsmappe. Methode und Einzelheiten: Excel API Antwortzeit.

Code-Beispiele

Eine Hilfsfunktion

async function calculate(serviceId, inputs, token) {
  const url =
    `https://spreadapi.io/api/v1/services/${serviceId}/execute?flatten=true`;
  const headers = { 'Content-Type': 'application/json' };
  if (token) headers.Authorization = `Bearer ${token}`;

  const response = await fetch(url, {
    method: 'POST',
    headers,
    body: JSON.stringify({ inputs })
  });
  const data = await response.json();
  if (!response.ok) throw new Error(data.message || data.error);
  return data.result;
}

Dynamische Preise

app.post('/api/quote', async (req, res) => {
  try {
    const quote = await calculate(
      PRICING_SERVICE_ID, req.body, process.env.SPREADAPI_TOKEN
    );
    res.json(quote);
  } catch (error) {
    res.status(400).json({ error: error.message });
  }
});

Behalte das Token auf deinem Server. Es gehört nicht in Code, der im Browser eines Besuchers läuft.

Mehrere Szenarien in einer Anfrage

const response = await fetch('https://spreadapi.io/d/{serviceId}', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    action: 'batch',
    scenarios: [
      { label: '4.0%', inputs: { principal: 500000, rate: 0.04, years: 30 } },
      { label: '4.5%', inputs: { principal: 500000, rate: 0.045, years: 30 } },
      { label: '5.0%', inputs: { principal: 500000, rate: 0.05, years: 30 } }
    ]
  })
});

const { scenarios } = await response.json();
// ein Eintrag pro Szenario, jeweils mit label, success und outputs

Das ist die Batch-Aktion der Discovery-Adresse eines Service. Sie nimmt 2 bis 20 Szenarien, und jedes berechnete Szenario zählt als ein Aufruf. Siehe Die Discovery-Adresse.

KI-Assistenten

Für Claude und ChatGPT schreibst du keinen Code. Jeder veröffentlichte Service hat eine MCP-Adresse, und ein Assistent, der unter https://spreadapi.io/mcp mit deinem Konto verbunden ist, erreicht die Services, die du erlaubst. Siehe Excel MCP Server.

Migrationsleitfaden

Schritt 1: Die Excel-Dateien finden, von denen dein Code abhängt

git grep -n -i -E 'xlsx|readFile|workbook'

Schritt 2: Jede Arbeitsmappe veröffentlichen

  • Die Excel-Datei in SpreadAPI importieren
  • Die Eingabezellen wählen
  • Die Ausgabezellen wählen
  • Mit Werten testen, deren Ergebnisse du kennst, dann veröffentlichen

Schritt 3: Den Parser-Code ersetzen

// Vorher: Parser plus nachgebaute Formeln
function calculatePrice(data) {
  const workbook = parseExcel('pricing.xlsx');
  // nachgebaute Formeln
  return price;
}

// Nachher: ein Aufruf
async function calculatePrice(data) {
  const result = await calculate(PRICING_SERVICE_ID, data);
  return result.price;
}

Was es nicht kann

  • VBA-Makros laufen nicht, und Verknüpfungen zu anderen Arbeitsmappen werden nicht verfolgt.
  • Ein Service nimmt nicht pro Aufruf eine beliebige hochgeladene Datei entgegen. Eine Arbeitsmappe wird einmal importiert und veröffentlicht; Aufrufer senden Eingabewerte.
  • Es gibt keine Versionshistorie eines Service. Aufrufer bekommen die veröffentlichte Version, bis du erneut veröffentlichst.
  • Eine Eingabe ist ein einzelner Wert: eine Zahl, ein Text oder ja/nein. Eine Ausgabe kann eine einzelne Zelle oder ein Zellbereich sein.

Siehe Unterstützte Excel-Funktionen.

Häufige Fragen

"Wird meine Logik offengelegt?"

Nein. Aufrufer sehen die Eingaben und Ausgaben, die du festgelegt hast, und die Ergebnisse ihrer eigenen Aufrufe. Eine Einstellung ändert das: Mit Excel-Export erlauben können Aufrufer die ausgefüllte Arbeitsmappe herunterladen, mit allen Formeln. Lass sie aus, wenn die Logik vertraulich ist.

"Was, wenn die Excel-Arbeitsmappe Fehler hat?"

Dann gibt die API zurück, was die Arbeitsmappe berechnet. Du behebst den Fehler einmal, in der Arbeitsmappe.

"Was kostet das?"

Der Basic-Plan ist kostenlos: ein veröffentlichter Service und 1.000 Aufrufe im Monat. Pro kostet 99 € im Monat, mit unbegrenzt vielen veröffentlichten Services und 10.000 Aufrufen im Monat. Siehe Preise.

Erste Schritte

  1. Nimm die Excel-Integration, die den meisten Ärger macht
  2. Registriere dich bei SpreadAPI
  3. Importiere die Arbeitsmappe und wähle Eingaben und Ausgaben
  4. Veröffentliche und mach deinen ersten Aufruf

SpreadAPI ausprobieren

Fragen? Schreib an support@airrange.io