diff --git a/docs/src/chapter-10-api/assets/api-architecture.svg b/docs/src/chapter-10-api/assets/api-architecture.svg new file mode 100644 index 00000000..b127ce71 --- /dev/null +++ b/docs/src/chapter-10-api/assets/api-architecture.svg @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + BotServer API Architecture + + + + + + Client Applications + + + + + + + + + HTTP/HTTPS + + + Port 8080 + + + + + + + + + API Gateway + + + /api/* + + + + + + + + + + + Auth Endpoints + + + /auth/login + + + /auth/logout + + + /auth/token + + + + + + Business Endpoints + + + /files/* • /users/* + + + /groups/* • /tasks/* + + + /sessions/* + + + + + + Admin Endpoints + + + /admin/* + + + /monitoring + + + /analytics + + + + + + + + + + + Service Layer + + + • Session Manager + + + • Auth Service • Bot Service + + + + + + + + + + + PostgreSQL + + + Database + + + Sessions • Users • Config + + + + + + Valkey + + + Cache + + + Semantic • Session • Temp + + + + + + Qdrant + + + Vectors + + + Embeddings • Search + + diff --git a/docs/src/chapter-10-api/assets/api-request-flow.svg b/docs/src/chapter-10-api/assets/api-request-flow.svg new file mode 100644 index 00000000..9cd6bf97 --- /dev/null +++ b/docs/src/chapter-10-api/assets/api-request-flow.svg @@ -0,0 +1,224 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + API Request Flow + + + + + + HTTP Request + + + Client → Server + + + + + + + + + Rate Limit + + + Check request limits + + + + + Pass + + + 429 Too Many + + + + + Auth + + + Validate token/session + + + + + Valid + + + 401 Unauthorized + + + + + Route + + + Match endpoint pattern + + + + + + + 404 Not Found + + + + + Validate + + + Check request body + + + + + Valid + + + 400 Bad Request + + + + + Process + + + Execute business logic + + + + + + + + + Format + + + JSON response + + + + + + + + + HTTP Response + + + Server → Client + + + + + + Error Response + + + + + + Request Pipeline + + + + + + + Success path + + + + + Error path + +