Differences

This shows you the differences between two versions of the page.

--- tanszek:oktatas:iss_t:rest_api [2026/03/01 17:17] – [Core REST Principles] knehez
+++ tanszek:oktatas:iss_t:rest_api [2026/03/01 17:24] (current) – [Core REST Principles] knehez
@@ Line 63: / Line 63: @@
 { "id": 1, "name": "Alice", "email": "alice@example.com" }
 </code>
+==== REST vs JSON-RPC ====
+^ Feature ^ REST ^ JSON-RPC ^
+| Architecture | Resource-based | Procedure-based |
+| Endpoints | Multiple | Usually single |
+| Uses HTTP verbs | Yes | Not required |
+| Standardized by | Architectural constraints | Protocol specification |
+| Typical use case | Public APIs | Internal APIs |
+REST is typically used for public web APIs, while JSON-RPC is often used in internal systems and blockchain interfaces.
+===== REST API Server (Python + Flask) =====
+In this section, we implement a simple REST API using Flask.
+Install dependency:
+<code bash> pip install flask </code>
+Create file: //server.py//
+<sxh python>
+from flask import Flask, jsonify, request
+app = Flask(__name__)
+users = [
+    {"id": 1, "name": "Alice"},
+    {"id": 2, "name": "Bob"},
+]
+@app.route("/users", methods=["GET"])
+def get_users():
+    return jsonify(users)
+@app.route("/users/<int:user_id>", methods=["GET"])
+def get_user(user_id):
+    for user in users:
+        if user["id"] == user_id:
+            return jsonify(user)
+    return jsonify({"error": "User not found"}), 404
+@app.route("/users", methods=["POST"])
+def create_user():
+    new_user = request.get_json()
+    new_user["id"] = len(users) + 1
+    users.append(new_user)
+    return jsonify(new_user), 201
+@app.route("/users/<int:user_id>", methods=["DELETE"])
+def delete_user(user_id):
+    global users
+    users = [u for u in users if u["id"] != user_id]
+    return jsonify({"message": "User deleted"})
+if __name__ == "__main__":
+    app.run(port=5000)
+</sxh>
+Run:
+<code bash> python server.py </code>
+===== Testing with curl =====
+Get all users:
+<code bash> curl http://localhost:5000/users </code>
+Create new user:
+<code bash> curl -X POST http://localhost:5000/users \ -H "Content-Type: application/json" \ -d '{"name":"Charlie"}' </code>
+Delete user:
+<code bash> curl -X DELETE http://localhost:5000/users/1 </code>
+==== HTTP Status Codes ====
+REST APIs rely heavily on HTTP status codes:
+^ Code ^ Meaning ^
+| 200 | OK |
+| 201 | Created |
+| 400 | Bad request |
+| 401 | Unauthorized |
+| 404 | Not found |
+| 500 | Server error |
+Status codes are an essential part of REST communication.
+==== Advantages and Limitations ====
+REST is widely adopted, easy to understand, and integrates naturally with HTTP infrastructure. It supports caching, authentication mechanisms, and standard tooling.
+However, REST can sometimes be verbose. Complex operations may require multiple endpoints, and over-fetching or under-fetching data can become an issue in large systems.