API i MCP dla partnerów
Przekazuj mi zadania bezpośrednio ze swoich programów lub przez asystenta AI: wysyłasz zadanie - dostajesz cenę i termin - akceptujesz - zaczynam pracę. To samo API udostępnia katalog moich 8 usług.
Zlecenie przez API
Klucz API nie jest potrzebny. W odpowiedzi na nowe zlecenie dostajesz numer zlecenia i klucz zlecenia: z nimi sprawdzasz status i odpowiadasz. Przez MCP to samo robią narzędzia create_order, get_order i order_action.
- Wysyłasz zadanie: POST /api/orders. Status received.
- Czytam zadanie i wpisuję do zlecenia cenę i termin. Status quoted.
- Akceptujesz cenę (accept z numerem wyceny quote_id), odrzucasz ją (decline) albo zadajesz pytanie (message).
- Po accept zaczynam pracę: status in_work, potem delivered z linkiem do wyniku.
- Odbierasz pracę (approve) - status closed, albo odsyłasz ją z uwagami (revision) - zlecenie wraca do in_work.
POST /api/orders | Nowe zlecenie. Wymagane: task (do 4000 znaków), contact i consent: true. Opcjonalnie: title, partner, ref (Twój numer zadania), deadline, budget, service, links (do 5 linków https), lang, callback_url, idempotency_key. |
|---|---|
GET /api/orders/{id} | Status, cena i termin (quote), wyniki (deliverables), zdarzenia, dostępne kroki (actions) oraz podpowiedź next: co zrobić dalej. Wymagany nagłówek Authorization: Bearer z kluczem zlecenia. |
POST /api/orders/{id} | Twój krok: action - accept (wymagane quote_id z quote.id), decline, cancel, approve, revision lub message; dla message i revision wymagane jest pole text. Ten sam nagłówek. |
curl -X POST 'https://fastdev24.com/api/orders' \
-H 'Content-Type: application/json' \
--data '{"task":"Landing page for a dental clinic: 5 sections, enquiry form, texts attached.","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"}'
Aby otrzymywać powiadomienia o zmianach zlecenia, podaj callback_url: przy każdym moim kroku wysyłam na ten adres POST z numerem zlecenia, statusem i ceną. Żądanie jest podpisane kluczem zlecenia (nagłówek X-Order-Signature), próby są dwie; jeśli Twój adres nie odpowie, stan zawsze możesz odczytać żądaniem GET. Aby powtórzenie żądania nie utworzyło drugiego zlecenia, podaj idempotency_key - własny losowy ciąg o długości co najmniej 16 znaków: powtórzenie z nim zwróci to samo zlecenie.
Katalog usług
Tylko odczyt, bez klucza API. Język odpowiedzi określa parametr lang: ru, pl, en, de, es lub fr (domyślnie en). Odpowiedzi w formacie JSON z nagłówkiem ETag, buforowane przez 5 minut.
GET /api/services?lang=pl | Lista usług: numer, slug, grupa, nazwa, efekt, czas realizacji i cena, jeśli jest opublikowana. |
|---|---|
GET /api/services/{id}?lang=pl | Opis usługi według numeru 1-8 lub identyfikatora z adresu (slug), np. web-design: zakres, czego potrzebuję od Ciebie, kontrola jakości, odbiór, FAQ. |
GET /openapi.json | Specyfikacja API w formacie OpenAPI 3.1. |
curl 'https://fastdev24.com/api/services/web-design?lang=pl'
Serwer MCP
Endpoint: https://fastdev24.com/mcp. Transport Streamable HTTP bez sesji: protokół w wersji 2026-07-28 oraz wcześniejsze wersje z inicjalizacją (initialize): 2025-11-25, 2025-06-18. Odpowiedzi w formacie JSON, bez strumienia SSE przez GET.
Narzędzia
list_services- lista usług w wybranym języku, opcjonalnie z filtrem według grupyget_service- pełny opis jednej usługicreate_request- zgłoszenie do mnie: kontakt, opis zadania do 600 znaków i akceptacja polityki prywatnościcreate_order- nowe zlecenie: zadanie, kontakt i zgoda; w odpowiedzi numer i klucz zleceniaget_order- status zlecenia, cena i termin, wyniki, zdarzeniaorder_action- akceptacja ceny, odmowa, anulowanie zlecenia, odbiór pracy, zwrot do poprawek lub wiadomość
Jak podłączyć
W kliencie, który obsługuje zdalne serwery MCP, dodaj serwer o adresie podanym powyżej. Przykład konfiguracji dla Claude Code (.mcp.json):
{
"mcpServers": {
"fastdev24": {
"type": "http",
"url": "https://fastdev24.com/mcp"
}
}
}
Przykład z wiersza poleceń - lista narzędzi. W żądaniach w wersji 2026-07-28 przekaż w _meta wersję protokołu i możliwości klienta:
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":{}}}}'
Ograniczenia
- Nowe zlecenia - około 20 na godzinę z adresu IP i około 100 na dobę łącznie. Treść żądania zlecenia - do 32 KB, kroku - do 16 KB. Dla jednego zlecenia - do 60 kroków na godzinę i do 20 wiadomości na dobę. Klucz zlecenia przechowuj u siebie: bez niego zlecenia nie da się odczytać. Zlecenie jest przechowywane 180 dni od ostatniej zmiany. Status sprawdzaj nie częściej niż raz na kilka minut. Jeśli przez 7 dni nie ma odpowiedzi na przekazany wynik, zamykam zlecenie.
- Limity zgłoszeń są orientacyjne: około 10 na godzinę z formularza i 30 przez MCP na adres IP oraz około 60 dziennie łącznie. Przy awarii lub równoczesnych żądaniach limity mogą nie zadziałać.
- Zgłoszenie wysyłaj dopiero po uzyskaniu wyraźnej zgody użytkownika: kontakt i opis zadania trafiają do mnie tak samo jak z formularza na stronie.
- Limit wywołań narzędzi MCP wynosi około 60 na minutę na adres IP w ramach jednej instancji serwera. Maksymalny rozmiar treści żądania: 64 KB dla MCP i 16 KB dla formularza.
- Odpowiedzi API: 400 (bad_lang, bad_group), 404 (not_found), 304, gdy ETag jest zgodny. Błędy create_request przychodzą jako wynik z isError i wyjaśnieniem.
- Katalog jest aktualizowany razem ze stroną; nowa wartość pola version lub nagłówka ETag tego samego zasobu i języka oznacza, że zmieniły się dane lub format odpowiedzi.