API und MCP für Partner
Geben Sie Aufgaben direkt aus Ihrer Software und Ihren KI-Assistenten an mich weiter: Aufgabe senden, Preis und Termin erhalten, zusagen - und ich beginne. Dieselbe API liefert den Katalog meiner 8 Leistungen.
Aufträge über die API
Ein API-Schlüssel ist nicht nötig. Beim Anlegen eines Auftrags erhalten Sie eine Auftragsnummer und einen Auftragsschlüssel: Damit lesen Sie den Status und antworten. Dieselben Schritte gibt es über MCP mit den Werkzeugen create_order, get_order und order_action.
- Sie senden die Aufgabe: POST /api/orders. Status: received.
- Ich lese die Aufgabe und trage Preis und Termin in den Auftrag ein. Status: quoted.
- Sie nehmen den Preis an (accept mit der Nummer des Preisangebots, quote_id), lehnen ab (decline) oder stellen eine Frage (message).
- Nach Ihrer Zusage beginne ich: Status in_work, danach delivered mit einem Link zum Ergebnis.
- Sie nehmen die Arbeit ab (approve) - Status closed - oder geben sie mit Anmerkungen zurück (revision): Dann steht der Auftrag wieder auf in_work.
POST /api/orders | Neuer Auftrag. Pflicht: task (bis 4.000 Zeichen), contact und consent: true. Optional: title, partner, ref (Ihre eigene Aufgabennummer), deadline, budget, service, links (bis zu 5 https-Links), lang, callback_url, idempotency_key. |
|---|---|
GET /api/orders/{id} | Status, Preis und Termin (quote), Ergebnisse (deliverables), Ereignisse, die jetzt möglichen Schritte (actions) und ein Hinweis, was als Nächstes zu tun ist (next). Benötigt den Header Authorization: Bearer mit dem Auftragsschlüssel. |
POST /api/orders/{id} | Ihr Schritt: action - accept (benötigt quote_id aus quote.id), decline, cancel, approve, revision oder message; message und revision brauchen text. Derselbe Header. |
curl -X POST 'https://fastdev24.com/api/orders' \
-H 'Content-Type: application/json' \
--data '{"task":"Landingpage für eine Zahnarztpraxis: 5 Abschnitte, Anfrageformular, Texte liegen bei.","contact":"dev@example.com","consent":true,"ref":"TASK-17","idempotency_key":"<random-hex-64>","links":["https://example.com/brief.pdf"]}'
curl 'https://fastdev24.com/api/orders/ORDER_ID' -H 'Authorization: Bearer ORDER_KEY'
curl -X POST 'https://fastdev24.com/api/orders/ORDER_ID' \
-H 'Authorization: Bearer ORDER_KEY' -H 'Content-Type: application/json' \
--data '{"action":"accept","quote_id":"QUOTE_ID"}'
Wenn Sie über Änderungen am Auftrag informiert werden möchten, übergeben Sie callback_url: Bei jeder Aktualisierung sende ich Auftragsnummer, Status und Preis per POST an diese Adresse. Die Anfrage ist mit dem Auftragsschlüssel signiert (Header X-Order-Signature); ich versuche zweimal, sie zuzustellen. Antwortet Ihre Adresse nicht, können Sie den Stand jederzeit per GET lesen. Damit eine Wiederholung sicher ist, übergeben Sie idempotency_key - eine eigene zufällige Zeichenfolge mit mindestens 16 Zeichen: Eine wiederholte Anfrage mit demselben Schlüssel liefert denselben Auftrag.
Leistungskatalog
Nur Lesezugriff, kein API-Schlüssel nötig. Der Parameter lang legt die Sprache der Antwort fest: ru, pl, en, de, es oder fr (Standard: en). Die Antworten sind JSON mit ETag und werden 5 Minuten zwischengespeichert.
GET /api/services?lang=de | Liste der Leistungen: Nummer, slug, Gruppe, Titel, Ergebnis, Dauer und Preis, soweit veröffentlicht. |
|---|---|
GET /api/services/{id}?lang=de | Eine Leistung nach Nummer 1-8 oder slug, z. B. web-design: Umfang, was ich von Ihnen brauche, Prüfungen, Abnahme, Fragen und Antworten. |
GET /openapi.json | OpenAPI-3.1-Beschreibung der API. |
curl 'https://fastdev24.com/api/services/web-design?lang=de'
MCP-Server
Endpunkt: https://fastdev24.com/mcp. Zustandsloser Streamable-HTTP-Transport (ohne Sitzungen): Protokollversion 2026-07-28 und die früheren Versionen mit initialize 2025-11-25, 2025-06-18. Die Antworten sind einfaches JSON; einen SSE-Stream über GET gibt es nicht.
Werkzeuge
list_services- Liste der Leistungen in der gewählten Sprache, auf Wunsch nach Gruppe gefiltertget_service- alle Angaben zu einer Leistungcreate_request- eine Anfrage an mich: Kontaktdaten, Beschreibung der Aufgabe mit bis zu 600 Zeichen und Einwilligung in die Datenverarbeitungcreate_order- ein neuer Auftrag: Aufgabe, Kontakt und Einwilligung; liefert Auftragsnummer und Schlüsselget_order- Status des Auftrags, Preis und Termin, Ergebnisse, Ereignisseorder_action- Preis annehmen oder ablehnen, Auftrag stornieren, Arbeit abnehmen, zur Korrektur zurückgeben oder eine Nachricht senden
So verbinden Sie sich
Fügen Sie in einem Client, der Remote-MCP-Server unterstützt, einen Server mit dem obigen Endpunkt hinzu. Beispiel für Claude Code (.mcp.json):
{
"mcpServers": {
"fastdev24": {
"type": "http",
"url": "https://fastdev24.com/mcp"
}
}
}
Beispiel für die Kommandozeile: Liste der Werkzeuge. Bei Version 2026-07-28 gehören Protokollversion und Client-Fähigkeiten in _meta:
curl -X POST 'https://fastdev24.com/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2026-07-28' -H 'Mcp-Method: tools/list' \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'
Limits
- Neue Aufträge: etwa 20 pro Stunde je IP-Adresse und etwa 100 pro Tag insgesamt. Request-Body: bis 32 KB für einen neuen Auftrag, 16 KB für einen Schritt. Je Auftrag: bis zu 60 Schritte pro Stunde und 20 Nachrichten pro Tag. Bewahren Sie den Auftragsschlüssel auf: Ohne ihn lässt sich der Auftrag nicht lesen. Aufträge werden 180 Tage nach der letzten Änderung gespeichert. Fragen Sie den Status höchstens alle paar Minuten ab. Bleibt ein geliefertes Ergebnis 7 Tage ohne Antwort, schließe ich den Auftrag.
- Die Limits für Anfragen sind Näherungswerte: etwa 10 pro Stunde über das Formular und 30 über MCP je IP-Adresse, insgesamt etwa 60 pro Tag. Bei Störungen oder gleichzeitigen Anfragen können sie abweichen.
- Senden Sie eine Anfrage erst, wenn die Person ausdrücklich eingewilligt hat: Kontaktdaten und Aufgabe kommen bei mir genauso an wie über das Formular der Website.
- MCP-Werkzeugaufrufe sind auf etwa 60 pro Minute je IP-Adresse und Serverinstanz begrenzt. Maximale Größe des Request-Bodys: 64 KB für MCP, 16 KB für das Formular.
- Die API antwortet auch mit 400 (bad_lang, bad_group), 404 (not_found) und 304, wenn das ETag passt. Eingabefehler bei create_request liefern isError mit einer Erklärung.
- Der Katalog wird zusammen mit der Website aktualisiert; ein neuer Wert von version oder ein neues ETag für dieselbe Ressource und Sprache bedeutet, dass sich Daten oder Antwortformat geändert haben.