Integracja sztucznej inteligencji

Podłącz swojego asystenta kodowania AI bezpośrednio do SprintFlint za pomocą REST API. Otrzymuj przypisane zadania, aktualizuj status i dodawaj komentarze bez opuszczania edytora.

Edytor obsługujący MCP? Większość użytkowników chce Serwer MCP pod adresem mcp.sprintflint.com zamiast tego; wrzuć do niego jeden blok JSON Claude Desktop, Cursor, Claude Code lub Zed a agent rozmawia z SprintFlint natywnie. Na tej stronie omówiono REST API niższego poziomu w przypadku wszystkiego, co MCP nie pasuje.

Jak to działa

Asystenci AI lubią Cursor i Klaudiusz możesz używać REST API SprintFlint do bezpośredniej pracy z zadaniami. Użyj umiejętności agenta lub niestandardowych narzędzi, aby zapewnić AI dostęp do danych sprintu.

Punkty końcowe API

SprintFlint udostępnia następujące punkty końcowe REST API:

Punkt końcowy	Metody	Opis
`/api/v1/projects`	POBIERZ, WYŚLIJ	Listuj i twórz projekty
`/api/v1/projects/:id`	POBIERZ, POPRAW, USUŃ	Pobierz, zaktualizuj lub usuń projekt
`/api/v1/projects/:id/sprints`	POBIERZ, WYŚLIJ	Listuj i twórz sprinty
`/api/v1/projects/:id/sprints/:id`	POBIERZ, POPRAW, USUŃ	Pobierz, zaktualizuj lub usuń sprint
`/api/v1/projects/:id/sprints/:id/issues`	POBIERZ, WYŚLIJ	Listuj i twórz problemy
`/api/v1/projects/:id/sprints/:id/issues/:id`	POBIERZ, POPRAW, USUŃ	Pobierz, zaktualizuj lub usuń problem
`/api/v1/.../issues/:id/comments`	POBIERZ, WYŚLIJ	Listuj i twórz komentarze
`/api/v1/comments/:id`	POBIERZ, POPRAW, USUŃ	Pobierz, zaktualizuj lub usuń komentarz

Konfiguracja

1. Wygeneruj token API

Kliknij swój awatar na pasku bocznym
Przejdź do „Mój profil”
Przewiń do sekcji „Token API”.
Kliknij „Wygeneruj token”
Skopiuj i bezpiecznie przechowuj swój token

2. Użyj API

Dołącz swój token do X-API-Token nagłówek:

curl -H "X-API-Token: YOUR_API_TOKEN" \
  https://sprintflint.com/api/v1/projects

3. Skonfiguruj Asystenta AI

Dodaj Umiejętności agenta SprintFlint do asystenta AI lub utwórz niestandardowe narzędzia wywołujące REST API.

Bezpieczeństwo tokenów - Twój token API zapewnia taki sam dostęp, jak Twoje zalogowane konto. Zachowaj to w tajemnicy i nigdy nie przekazuj tego kontroli wersji.

Przykłady użycia

Po skonfigurowaniu możesz zadać swojemu asystentowi AI następujące pytania:

„Jakie problemy występują w bieżącym sprincie?”
„Pokaż mi szczegóły PROJ-123”
„Aktualizuj status PROJ-123 do stanu w toku”
„Dodaj komentarz do PROJ-123: Rozpoczęto prace nad integracją API”
„Utwórz nowy problem: napraw styl przycisku logowania”

Przykładowe wywołania API

Lista projektów

GET /api/v1/projects
X-API-Token: YOUR_TOKEN

Utwórz problem

POST /api/v1/projects/1/sprints/1/issues
X-API-Token: YOUR_TOKEN
Content-Type: application/json

{
  "issue": {
    "title": "Fix login button",
    "status": "todo",
    "story_points": 2
  }
}

Zaktualizuj status problemu

PATCH /api/v1/projects/1/sprints/1/issues/123
X-API-Token: YOUR_TOKEN
Content-Type: application/json

{
  "issue": {
    "status": "done"
  }
}

Dodaj komentarz

POST /api/v1/projects/1/sprints/1/issues/123/comments
X-API-Token: YOUR_TOKEN
Content-Type: application/json

{
  "comment": {
    "body": "Started working on this ticket"
  }
}

Typowy przepływ pracy

Rozpocznij swój dzień - Lista problemów w bieżącym sprincie
Wybierz zadanie - Uzyskaj szczegółowe informacje na temat konkretnego problemu
Rozpocznij pracę - Aktualizuj status do in_progress
Śledź postęp - Dodawaj komentarze podczas pracy
Kompletny - Aktualizuj status do done

Pełna dokumentacja API

Pełna dokumentacja API, w tym schematy żądań/odpowiedzi, znajduje się w pliku Odniesienie API.

Rozwiązywanie problemów

Błędy uwierzytelniania

Jeśli pojawi się błąd „Nieprawidłowy token API”:

Sprawdź, czy Twój token został poprawnie skopiowany (bez dodatkowych spacji)
Sprawdź, czy token nie został zregenerowany
Upewnij się, że format nagłówka to X-API-Token: YOUR_TOKEN

404 Nie znaleziono

Jeśli nie znaleziono zasobów:

Sprawdź, czy masz dostęp do projektu/sprintu
Sprawdź, czy identyfikatory w żądaniu są prawidłowe

Potrzebujesz pomocy?

Jeśli masz pytania dotyczące integracji AI lub potrzebujesz pomocy, skontaktuj się z nami pod adresem [email protected].