Klasy zasobów i obiekt Api
Modeluj endpointy jako zasoby z metodami HTTP.
Klasy zasobów i obiekt Api to bezpłatna lekcja Flask Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Flask Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Flask Academy zawiera 4 lekcji w sumie.
Lepszy sposób budowania API
Zwykłe trasy Flask działają, ale w przypadku API Flask-RESTful zapewnia uporządkowaną strukturę opartą na klasach, która skaluje się wraz z rozwojem endpointów. 🧩
Zainstaluj rozszerzenie
Flask-RESTful jest dostarczany osobno. Dodaj go do projektu za pomocą pip, zanim cokolwiek z niego zaimportujesz.
pip install flask-restfulZaimportuj elementy
Potrzebujesz dwóch nazw: Api — obiektu zarządzającego, który łączy endpointy — oraz Resource, klasy bazowej dla każdego z nich.
from flask_restful import Api, ResourceOwiń aplikację w obiekt Api
Utwórz obiekt Api wokół aplikacji Flask. Staje się on rejestrem, w którym montowany jest każdy zasób.
app = Flask(__name__)
api = Api(app)Czym jest Resource
Resource to klasa Pythona reprezentująca jedną rzecz w API, na przykład zadanie lub użytkownika, zebraną w jednym miejscu.
class HelloWorld(Resource):
passUtwórz podklasę Resource
Każdy tworzony endpoint zaczyna się od utworzenia podklasy Resource. Metody w jej wnętrzu będą obsługiwać czasowniki HTTP.
class TaskList(Resource):
def get(self):
return {"tasks": []}Zamontuj zasób pod adresem URL
Użyj add_resource, aby przypisać klasę zasobu do ścieżki URL. W ten sposób Api dowiaduje się, gdzie znajduje się zasób.
api.add_resource(TaskList, "/tasks")Zwracaj zwykłe słowniki
Po prostu zwróć pythonowy dict, a Flask-RESTful automatycznie zserializuje go do JSON. Nie musisz ręcznie używać jsonify. ✨
def get(self):
return {"message": "hello"}Koniec z dekoratorami tras
Zauważ, że całkowicie pomijasz @app.route. Obiekt Api i add_resource zastępują sposób pracy oparty na dekoratorach.
Uruchamiaj jak każdą aplikację Flask
Uruchamianie pozostaje bez zmian: to samo app.run udostępnia API oparte na zasobach na serwerze deweloperskim.
if __name__ == "__main__":
app.run(debug=True)Dlaczego klasy pomagają
Grupowanie powiązanych czasowników w jednej class sprawia, że każdy endpoint jest samowystarczalny i znacznie łatwiejszy do odczytania niż rozproszone funkcje.
Szybkie sprawdzenie
Jaki obiekt łączy klasę Resource z adresem URL?
Podsumowanie: zasoby i Api
Owinąłeś aplikację w obiekt Api, utworzyłeś podklasę Resource i zamontowałeś ją za pomocą add_resource. To czysty szkielet API! 🎉
Często zadawane pytania
Czy lekcja „Klasy zasobów i obiekt Api” jest bezpłatna?
Tak — pełny tekst „Klasy zasobów i obiekt Api” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Flask Academy, przejdź na CoddyKit PRO. Kurs Flask Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Klasy zasobów i obiekt Api”?
Modeluj endpointy jako zasoby z metodami HTTP. Ćwiczysz Flask Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Flask Academy?
Nie wymagamy żadnego doświadczenia. Flask Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.
Ile czasu zajmuje lekcja „Klasy zasobów i obiekt Api”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Flask Academy?
Tak. Każda lekcja Flask Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Klasy zasobów i obiekt Api
- Mapowanie metod HTTP na handlery klas
- Analizowanie i walidacja za pomocą reqparse
- Zasoby REST zamontowane w Blueprintach