PL
Opisz zadanie

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.

  1. Wysyłasz zadanie: POST /api/orders. Status received.
  2. Czytam zadanie i wpisuję do zlecenia cenę i termin. Status quoted.
  3. Akceptujesz cenę (accept z numerem wyceny quote_id), odrzucasz ją (decline) albo zadajesz pytanie (message).
  4. Po accept zaczynam pracę: status in_work, potem delivered z linkiem do wyniku.
  5. Odbierasz pracę (approve) - status closed, albo odsyłasz ją z uwagami (revision) - zlecenie wraca do in_work.
POST /api/ordersNowe 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=plLista usług: numer, slug, grupa, nazwa, efekt, czas realizacji i cena, jeśli jest opublikowana.
GET /api/services/{id}?lang=plOpis 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.jsonSpecyfikacja 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 grupy
  • get_service - pełny opis jednej usługi
  • create_request - zgłoszenie do mnie: kontakt, opis zadania do 600 znaków i akceptacja polityki prywatności
  • create_order - nowe zlecenie: zadanie, kontakt i zgoda; w odpowiedzi numer i klucz zlecenia
  • get_order - status zlecenia, cena i termin, wyniki, zdarzenia
  • order_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.