{"id":774,"date":"2026-02-23T22:28:44","date_gmt":"2026-02-23T14:28:44","guid":{"rendered":"https:\/\/blog.itsmygo.uk\/2026\/02\/23\/%e3%80%90%e5%b7%a5%e7%a8%8b%e5%b8%ab%e7%9a%84%e7%b3%bb%e7%b5%b1%e8%a8%ad%e8%a8%88%e3%80%9102-api-%e8%a8%ad%e8%a8%88%ef%bc%9a%e6%89%93%e9%80%a0%e7%b3%bb%e7%b5%b1%e7%9a%84%e6%ba%9d%e9%80%9a%e5%a5%91\/"},"modified":"2026-02-23T22:28:44","modified_gmt":"2026-02-23T14:28:44","slug":"%e3%80%90%e5%b7%a5%e7%a8%8b%e5%b8%ab%e7%9a%84%e7%b3%bb%e7%b5%b1%e8%a8%ad%e8%a8%88%e3%80%9102-api-%e8%a8%ad%e8%a8%88%ef%bc%9a%e6%89%93%e9%80%a0%e7%b3%bb%e7%b5%b1%e7%9a%84%e6%ba%9d%e9%80%9a%e5%a5%91","status":"publish","type":"post","link":"https:\/\/blog.itsmygo.uk\/wordpress\/2026\/02\/23\/%e3%80%90%e5%b7%a5%e7%a8%8b%e5%b8%ab%e7%9a%84%e7%b3%bb%e7%b5%b1%e8%a8%ad%e8%a8%88%e3%80%9102-api-%e8%a8%ad%e8%a8%88%ef%bc%9a%e6%89%93%e9%80%a0%e7%b3%bb%e7%b5%b1%e7%9a%84%e6%ba%9d%e9%80%9a%e5%a5%91\/","title":{"rendered":"\u3010\u5de5\u7a0b\u5e2b\u7684\u7cfb\u7d71\u8a2d\u8a08\u3011#02 API \u8a2d\u8a08\uff1a\u6253\u9020\u7cfb\u7d71\u7684\u6e9d\u901a\u5951\u7d04"},"content":{"rendered":"\n<div id=\"quiz-127c1d22\">\n<style>\n#quiz-127c1d22 .question {\n        background: white;\n        border-radius: 8px;\n        padding: 20px;\n        margin: 20px 0;\n        box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);\n      }#quiz-127c1d22 .question h3 {\n        margin-top: 0;\n        color: #333;\n      }#quiz-127c1d22 .options {\n        list-style: none;\n        padding: 0;\n      }#quiz-127c1d22 .options li {\n        padding: 12px 15px;\n        margin: 8px 0;\n        border: 2px solid #ddd;\n        border-radius: 6px;\n        cursor: pointer;\n        transition: all 0.2s;\n      }#quiz-127c1d22 .options li:hover:not(.disabled) {\n        border-color: #4caf50;\n        background: #f0fff0;\n      }#quiz-127c1d22 .options li.correct {\n        border-color: #4caf50;\n        background: #e8f5e9;\n      }#quiz-127c1d22 .options li.wrong {\n        border-color: #f44336;\n        background: #ffebee;\n      }#quiz-127c1d22 .options li.disabled {\n        cursor: default;\n        opacity: 0.7;\n      }#quiz-127c1d22 .options li.show-answer {\n        border-color: #4caf50;\n        background: #e8f5e9;\n      }#quiz-127c1d22 .feedback {\n        margin-top: 15px;\n        padding: 12px;\n        border-radius: 6px;\n        display: none;\n      }#quiz-127c1d22 .feedback.correct {\n        background: #e8f5e9;\n        color: #2e7d32;\n        display: block;\n      }#quiz-127c1d22 .feedback.wrong {\n        background: #ffebee;\n        color: #c62828;\n        display: block;\n      }#quiz-127c1d22 .score {\n        text-align: center;\n        font-size: 1.5em;\n        padding: 20px;\n        background: white;\n        border-radius: 8px;\n        margin-top: 20px;\n      }#quiz-127c1d22 .code-block {\n        background: #1e1e1e;\n        color: #d4d4d4;\n        padding: 14px;\n        border-radius: 6px;\n        font-family: \"Monaco\", \"Consolas\", \"Courier New\", monospace;\n        font-size: 0.9em;\n        overflow-x: auto;\n        margin: 12px 0;\n        white-space: pre-wrap;\n      }\n<\/style>\n<h1>\u6e2c\u9a57\uff1aAPI \u8a2d\u8a08 &#8212; \u6253\u9020\u7cfb\u7d71\u7684\u6e9d\u901a\u5951\u7d04<\/h1>\n    <p>\u5171 5 \u984c\uff0c\u9ede\u9078\u7b54\u6848\u5f8c\u6703\u7acb\u5373\u986f\u793a\u7d50\u679c<\/p>\n\n    <div class=\"question\" id=\"q1\">\n      <h3>1. \u5728 RESTful API \u8a2d\u8a08\u4e2d\uff0cURL \u61c9\u8a72\u4ee3\u8868\u4ec0\u9ebc\uff1f<\/h3>\n      <ul class=\"options\">\n        <li onclick=\"checkAnswer(1, 'A', 'B')\">A. \u52d5\u4f5c\uff08\u4f8b\u5982 <code>\/getUsers<\/code>\u3001<code>\/deleteUser<\/code>\uff09<\/li>\n        <li onclick=\"checkAnswer(1, 'B', 'B')\">B. \u8cc7\u6e90\uff08\u4f8b\u5982 <code>\/users<\/code>\u3001<code>\/users\/123<\/code>\uff09<\/li>\n        <li onclick=\"checkAnswer(1, 'C', 'B')\">C. \u529f\u80fd\u6a21\u7d44\uff08\u4f8b\u5982 <code>\/module\/user-management<\/code>\uff09<\/li>\n        <li onclick=\"checkAnswer(1, 'D', 'B')\">D. \u7248\u672c\u865f\uff08\u4f8b\u5982 <code>\/v1\/v2\/endpoint<\/code>\uff09<\/li>\n      <\/ul>\n      <div class=\"feedback\" id=\"fb1\"><\/div>\n    <\/div>\n\n    <div class=\"question\" id=\"q2\">\n      <h3>2. \u70ba\u4ec0\u9ebc POST \u65b9\u6cd5\u88ab\u7a31\u70ba\u300c\u4e0d\u51aa\u7b49\u300d\uff1f<\/h3>\n      <ul class=\"options\">\n        <li onclick=\"checkAnswer(2, 'A', 'C')\">A. \u56e0\u70ba POST \u4e0d\u9700\u8981\u50b3\u9001 body<\/li>\n        <li onclick=\"checkAnswer(2, 'B', 'C')\">B. \u56e0\u70ba POST \u6bcf\u6b21\u547c\u53eb\u90fd\u53ef\u80fd\u5931\u6557<\/li>\n        <li onclick=\"checkAnswer(2, 'C', 'C')\">C. \u56e0\u70ba\u91cd\u8907\u547c\u53eb POST \u6703\u5efa\u7acb\u591a\u7b46\u65b0\u8cc7\u6599\uff0c\u7d50\u679c\u4e0d\u540c<\/li>\n        <li onclick=\"checkAnswer(2, 'D', 'C')\">D. \u56e0\u70ba POST \u4e0d\u652f\u63f4 JSON \u683c\u5f0f<\/li>\n      <\/ul>\n      <div class=\"feedback\" id=\"fb2\"><\/div>\n    <\/div>\n\n    <div class=\"question\" id=\"q3\">\n      <h3>3. \u7576 API \u56de\u50b3 HTTP \u72c0\u614b\u78bc 401 \u6642\uff0c\u4ee3\u8868\u4ec0\u9ebc\u610f\u601d\uff1f<\/h3>\n      <ul class=\"options\">\n        <li onclick=\"checkAnswer(3, 'A', 'B')\">A. \u8acb\u6c42\u683c\u5f0f\u4e0d\u6b63\u78ba<\/li>\n        <li onclick=\"checkAnswer(3, 'B', 'B')\">B. \u6c92\u6709\u767b\u5165\uff08\u8eab\u4efd\u9a57\u8b49\u5931\u6557\uff09<\/li>\n        <li onclick=\"checkAnswer(3, 'C', 'B')\">C. \u6709\u767b\u5165\u4f46\u6c92\u6709\u6b0a\u9650<\/li>\n        <li onclick=\"checkAnswer(3, 'D', 'B')\">D. \u8acb\u6c42\u7684\u8cc7\u6e90\u4e0d\u5b58\u5728<\/li>\n      <\/ul>\n      <div class=\"feedback\" id=\"fb3\"><\/div>\n    <\/div>\n\n    <div class=\"question\" id=\"q4\">\n      <h3>4. \u95dc\u65bc API \u7248\u672c\u63a7\u5236\uff0c\u4ee5\u4e0b\u54ea\u7a2e\u4fee\u6539\u300c\u4e0d\u9700\u8981\u300d\u5347\u7248\uff1f<\/h3>\n      <ul class=\"options\">\n        <li onclick=\"checkAnswer(4, 'A', 'A')\">A. \u65b0\u589e\u4e00\u500b\u9078\u586b\u7684 query parameter<\/li>\n        <li onclick=\"checkAnswer(4, 'B', 'A')\">B. \u522a\u9664\u4e00\u500b\u56de\u61c9\u4e2d\u7684\u6b04\u4f4d<\/li>\n        <li onclick=\"checkAnswer(4, 'C', 'A')\">C. \u6539\u8b8a\u67d0\u500b\u6b04\u4f4d\u7684\u8cc7\u6599\u578b\u5225<\/li>\n        <li onclick=\"checkAnswer(4, 'D', 'A')\">D. \u91cd\u65b0\u547d\u540d\u4e00\u500b\u5fc5\u8981\u53c3\u6578<\/li>\n      <\/ul>\n      <div class=\"feedback\" id=\"fb4\"><\/div>\n    <\/div>\n\n    <div class=\"question\" id=\"q5\">\n      <h3>5. \u5728\u5206\u9801\u8a2d\u8a08\u4e2d\uff0c\u4ec0\u9ebc\u60c5\u6cc1\u4e0b cursor-based \u5206\u9801\u6bd4 offset-based \u66f4\u9069\u5408\uff1f<\/h3>\n      <ul class=\"options\">\n        <li onclick=\"checkAnswer(5, 'A', 'D')\">A. \u5f8c\u53f0\u7ba1\u7406\u9801\u9762\u9700\u8981\u8df3\u5230\u7279\u5b9a\u9801\u78bc<\/li>\n        <li onclick=\"checkAnswer(5, 'B', 'D')\">B. \u8cc7\u6599\u91cf\u5f88\u5c0f\uff08\u4e0d\u5230\u4e00\u5343\u7b46\uff09<\/li>\n        <li onclick=\"checkAnswer(5, 'C', 'D')\">C. \u4f7f\u7528\u8005\u9700\u8981\u76f4\u63a5\u8f38\u5165\u9801\u78bc\u700f\u89bd<\/li>\n        <li onclick=\"checkAnswer(5, 'D', 'D')\">D. \u793e\u7fa4\u52d5\u614b\u7246\u7b49\u8cc7\u6599\u6301\u7e8c\u65b0\u589e\u7684\u5834\u666f<\/li>\n      <\/ul>\n      <div class=\"feedback\" id=\"fb5\"><\/div>\n    <\/div>\n\n    <div class=\"score\" id=\"score\" style=\"display:none;\"><\/div>\n<script>\n\n      let answered = 0;\n      let correct = 0;\n      const total = 5;\n      const explanations = {\n        1: \" RESTful \u8a2d\u8a08\u7684\u6838\u5fc3\u539f\u5247\u662f\u300c\u8cc7\u6e90\u5c0e\u5411\u300d\uff0cURL \u61c9\u8a72\u4f7f\u7528\u540d\u8a5e\u4ee3\u8868\u8cc7\u6e90\uff08\u5982 <code>\/users<\/code>\uff09\uff0c\u800c\u300c\u505a\u4ec0\u9ebc\u4e8b\u300d\u5247\u7531 HTTP \u65b9\u6cd5\uff08GET\u3001POST\u3001PUT\u3001DELETE\uff09\u6c7a\u5b9a\u3002\u7528\u52d5\u8a5e\u547d\u540d\uff08\u5982 <code>\/getUsers<\/code>\uff09\u4e0d\u7b26\u5408 RESTful \u98a8\u683c\u3002\",\n        2: \" \u51aa\u7b49\u6027\u6307\u7684\u662f\u300c\u547c\u53eb\u4e00\u6b21\u8ddf\u547c\u53eb\u591a\u6b21\u7d50\u679c\u76f8\u540c\u300d\u3002POST \u7528\u65bc\u5efa\u7acb\u65b0\u8cc7\u6599\uff0c\u6bcf\u6b21\u547c\u53eb\u90fd\u6703\u65b0\u589e\u4e00\u7b46\uff0c\u6240\u4ee5\u547c\u53eb\u5341\u6b21\u5c31\u6703\u7522\u751f\u5341\u7b46\u8cc7\u6599\uff0c\u7d50\u679c\u4e0d\u540c\u3002\u76f8\u8f03\u4e4b\u4e0b\uff0cDELETE \u4e0d\u7ba1\u522a\u5e7e\u6b21\uff0c\u90a3\u7b46\u8cc7\u6599\u6700\u7d42\u90fd\u662f\u88ab\u522a\u9664\u7684\u72c0\u614b\uff0c\u6240\u4ee5\u662f\u51aa\u7b49\u7684\u3002\",\n        3: \" 401 Unauthorized \u8868\u793a\u300c\u6c92\u6709\u767b\u5165\u300d\uff0c\u4e5f\u5c31\u662f\u8eab\u4efd\u9a57\u8b49\uff08Authentication\uff09\u5931\u6557\u3002\u800c 403 Forbidden \u8868\u793a\u300c\u6709\u767b\u5165\u4f46\u6c92\u6709\u6b0a\u9650\u300d\uff0c400 \u8868\u793a\u8acb\u6c42\u683c\u5f0f\u4e0d\u5c0d\uff0c404 \u8868\u793a\u8cc7\u6e90\u4e0d\u5b58\u5728\u3002\",\n        4: \" \u5411\u5f8c\u76f8\u5bb9\u7684\u4fee\u6539\uff08\u5982\u65b0\u589e\u6b04\u4f4d\u3001\u65b0\u589e endpoint\u3001\u65b0\u589e\u53ef\u9078\u7684 query parameter\uff09\u4e0d\u9700\u8981\u5347\u7248\u3002\u800c\u522a\u9664\u6b04\u4f4d\u3001\u6539\u8b8a\u8cc7\u6599\u578b\u5225\u3001\u91cd\u65b0\u547d\u540d\u53c3\u6578\u7b49\u300c\u7834\u58de\u6027\u4fee\u6539\u300d\u624d\u9700\u8981\u5347\u7248\u3002\u7c21\u55ae\u4f86\u8aaa\uff1a\u300c\u52a0\u6771\u897f\u300d\u4e0d\u7528\u5347\u7248\uff0c\u300c\u6539\u6771\u897f\u300d\u6216\u300c\u522a\u6771\u897f\u300d\u624d\u8981\u3002\",\n        5: \" Cursor-based \u5206\u9801\u9069\u5408\u8cc7\u6599\u6301\u7e8c\u65b0\u589e\u7684\u52d5\u614b\u5834\u666f\uff08\u5982\u793e\u7fa4\u52d5\u614b\u7246\uff09\uff0c\u56e0\u70ba offset-based \u5728\u8cc7\u6599\u65b0\u589e\u6642\u6703\u5c0e\u81f4\u91cd\u8907\u986f\u793a\u3002Cursor-based \u5f9e\u4e0a\u6b21\u7684\u4f4d\u7f6e\u7e7c\u7e8c\u5f80\u4e0b\u53d6\uff0c\u4e0d\u53d7\u65b0\u589e\u8cc7\u6599\u5f71\u97ff\u3002\u4f46\u5b83\u7684\u7f3a\u9ede\u662f\u7121\u6cd5\u8df3\u5230\u7279\u5b9a\u9801\u78bc\uff0c\u6240\u4ee5\u5f8c\u53f0\u7ba1\u7406\u9801\u9762\u66f4\u9069\u5408\u7528 offset-based\u3002\"\n      };\n\n      function checkAnswer(qNum, selected, correctAns) {\n        const question = document.getElementById(\"q\" + qNum);\n        if (question.classList.contains(\"answered\")) return;\n\n        question.classList.add(\"answered\");\n        answered++;\n\n        const options = question.querySelectorAll(\".options li\");\n        options.forEach((opt) => {\n          opt.classList.add(\"disabled\");\n          if (opt.textContent.startsWith(correctAns + \".\")) {\n            opt.classList.add(\"show-answer\");\n          }\n        });\n\n        const feedback = document.getElementById(\"fb\" + qNum);\n        if (selected === correctAns) {\n          correct++;\n          feedback.className = \"feedback correct\";\n          feedback.innerHTML = \"\u2713 \u6b63\u78ba\uff01\" + explanations[qNum];\n        } else {\n          feedback.className = \"feedback wrong\";\n          feedback.innerHTML =\n            \"\u2717 \u932f\u8aa4\u3002\u6b63\u78ba\u7b54\u6848\u662f \" + correctAns + \"\u3002\" + explanations[qNum];\n          options.forEach((opt) => {\n            if (opt.textContent.startsWith(selected + \".\")) {\n              opt.classList.add(\"wrong\");\n            }\n          });\n        }\n\n        if (answered === total) {\n          const scoreDiv = document.getElementById(\"score\");\n          scoreDiv.style.display = \"block\";\n          scoreDiv.innerHTML =\n            \"\u6e2c\u9a57\u5b8c\u6210\uff01\u5f97\u5206\uff1a\" +\n            correct +\n            \" \/ \" +\n            total +\n            (correct === total\n              ? \" \ud83c\udf89 \u5168\u5c0d\uff01\"\n              : correct >= Math.ceil(total * 0.6)\n                ? \" \ud83d\udc4d \u4e0d\u932f\uff01\"\n                : \" \ud83d\udcda \u518d\u8907\u7fd2\u4e00\u4e0b\u5427\");\n        }\n      }\n    \n<\/script>\n<\/div>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u7cfb\u7d71\u88e1\u7684\u6bcf\u500b\u5143\u4ef6\u90fd\u9700\u8981\u300c\u5c0d\u8a71\u300d\uff0c\u800c API \u5c31\u662f\u5b83\u5011\u4e4b\u9593\u7684\u5171\u540c\u8a9e\u8a00\u3002<br>\u8a2d\u8a08\u597d\u7684 API\uff0c\u5c31\u50cf\u7c3d\u4e00\u4efd\u6e05\u695a\u7684\u5951\u7d04 &#8212; \u96d9\u65b9\u90fd\u77e5\u9053\u8a72\u7d66\u4ec0\u9ebc\u3001\u6703\u62ff\u5230\u4ec0\u9ebc\u3002<\/p>\n<\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\">\u9019\u7bc7\u6587\u7ae0\u89e3\u6c7a\u4ec0\u9ebc\u554f\u984c\uff1f<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u4f60\u6709\u4ee5\u4e0b\u56f0\u60d1\uff0c\u9019\u7bc7\u6587\u7ae0\u9069\u5408\u4f60\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>AI \u5e6b\u4f60\u7522\u751f\u4e86\u4e00\u5806 API endpoint\uff0c\u4f46\u4f60\u4e0d\u78ba\u5b9a\u547d\u540d\u548c\u7d50\u69cb\u5c0d\u4e0d\u5c0d<\/li>\n\n\n<li>\u524d\u7aef\u547c\u53eb\u5f8c\u7aef API \u6642\uff0c\u4e0d\u77e5\u9053\u8a72\u7528 POST \u9084\u662f PUT\uff0c\u56de\u50b3\u683c\u5f0f\u4e5f\u4e0d\u4e00\u81f4<\/li>\n\n\n<li>\u7cfb\u7d71\u8d8a\u505a\u8d8a\u5927\uff0c\u820a\u7684 API \u6539\u4e86\u6703\u58de\u6389\u65b0\u529f\u80fd\uff0c\u4e0d\u77e5\u9053\u600e\u9ebc\u7ba1\u7406\u7248\u672c<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">\u4e00\u53e5\u8a71\u8aaa\u660e<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">API \u662f\u7cfb\u7d71\u5143\u4ef6\u4e4b\u9593\u7684\u6e9d\u901a\u5951\u7d04\uff0c\u5b9a\u7fa9\u597d\u300c\u600e\u9ebc\u554f\u3001\u600e\u9ebc\u7b54\u300d\uff0c\u7cfb\u7d71\u624d\u80fd\u7a69\u5b9a\u64f4\u5c55\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">API \u5728\u7cfb\u7d71\u8a2d\u8a08\u4e2d\u7684\u89d2\u8272<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u5728\u4e0a\u4e00\u7bc7\u6211\u5011\u8ac7\u4e86\u7cfb\u7d71\u8a2d\u8a08\u601d\u7dad\uff0c\u77e5\u9053\u7cfb\u7d71\u662f\u7531\u591a\u500b\u5143\u4ef6\u7d44\u6210\u7684\u3002\u90a3\u9019\u4e9b\u5143\u4ef6\u600e\u9ebc\u6e9d\u901a\uff1f\u7b54\u6848\u5c31\u662f API\u3002<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     API      \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502  \u524d\u7aef App \u2502 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2192  \u2502  \u5f8c\u7aef API \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                               \u2502 API\n                               \u25bc\n                          \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                          \u2502  \u8cc7\u6599\u5eab   \u2502\n                          \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">API \u51fa\u73fe\u5728\u4e09\u500b\u95dc\u9375\u4f4d\u7f6e\uff1a<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table>\n<thead>\n<tr>\n<th>\u5834\u666f<\/th>\n<th>\u8ab0\u8ddf\u8ab0\u6e9d\u901a<\/th>\n<th>\u7bc4\u4f8b<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>\u524d\u5f8c\u7aef\u5206\u96e2<\/td>\n<td>\u700f\u89bd\u5668 \u2192 \u5f8c\u7aef\u4f3a\u670d\u5668<\/td>\n<td>React \u547c\u53eb FastAPI<\/td>\n<\/tr>\n<tr>\n<td>\u5fae\u670d\u52d9\u901a\u8a0a<\/td>\n<td>\u670d\u52d9 A \u2192 \u670d\u52d9 B<\/td>\n<td>\u8a02\u55ae\u670d\u52d9 \u2192 \u5eab\u5b58\u670d\u52d9<\/td>\n<\/tr>\n<tr>\n<td>\u7b2c\u4e09\u65b9\u6574\u5408<\/td>\n<td>\u4f60\u7684\u7cfb\u7d71 \u2192 \u5916\u90e8\u670d\u52d9<\/td>\n<td>\u4f60\u7684 App \u2192 Stripe \u4ed8\u6b3e<\/td>\n<\/tr>\n<\/tbody>\n<\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u91cd\u9ede<\/strong>\uff1a\u4e0d\u7ba1\u54ea\u500b\u5834\u666f\uff0c\u6838\u5fc3\u6982\u5ff5\u90fd\u4e00\u6a23 &#8212; \u96d9\u65b9\u7d04\u5b9a\u597d\u300c\u8acb\u6c42\u683c\u5f0f\u300d\u548c\u300c\u56de\u61c9\u683c\u5f0f\u300d\uff0c\u9019\u5c31\u662f\u5951\u7d04\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">RESTful API \u8a2d\u8a08\u539f\u5247<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">REST \u662f\u76ee\u524d\u6700\u4e3b\u6d41\u7684 API \u8a2d\u8a08\u98a8\u683c\u3002\u4f60\u5728\u5927\u591a\u6578 AI \u751f\u6210\u7684\u5f8c\u7aef\u7a0b\u5f0f\u78bc\u4e2d\u90fd\u6703\u770b\u5230\u5b83\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u539f\u5247 1\uff1a\u8cc7\u6e90\u5c0e\u5411\u7684 URL<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">URL \u4ee3\u8868\u300c\u8cc7\u6e90\u300d\uff08\u540d\u8a5e\uff09\uff0c\u4e0d\u662f\u300c\u52d5\u4f5c\u300d\uff08\u52d5\u8a5e\uff09\u3002<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-1\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-comment\"># \u597d\u7684\u8a2d\u8a08 -- URL \u662f\u540d\u8a5e<\/span>\nGET    \/users          <span class=\"hljs-comment\"># \u53d6\u5f97\u6240\u6709\u4f7f\u7528\u8005<\/span>\nGET    \/users\/<span class=\"hljs-number\">123<\/span>      <span class=\"hljs-comment\"># \u53d6\u5f97 ID \u70ba 123 \u7684\u4f7f\u7528\u8005<\/span>\nPOST   \/users          <span class=\"hljs-comment\"># \u5efa\u7acb\u65b0\u4f7f\u7528\u8005<\/span>\nPUT    \/users\/<span class=\"hljs-number\">123<\/span>      <span class=\"hljs-comment\"># \u66f4\u65b0 ID \u70ba 123 \u7684\u4f7f\u7528\u8005<\/span>\nDELETE \/users\/<span class=\"hljs-number\">123<\/span>      <span class=\"hljs-comment\"># \u522a\u9664 ID \u70ba 123 \u7684\u4f7f\u7528\u8005<\/span>\n\n<span class=\"hljs-comment\"># \u4e0d\u597d\u7684\u8a2d\u8a08 -- URL \u662f\u52d5\u8a5e<\/span>\nGET    \/getUsers\nPOST   \/createUser\nPOST   \/deleteUser\/<span class=\"hljs-number\">123<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-1\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7ffb\u8b6f<\/strong>\uff1a\u628a URL \u60f3\u6210\u300c\u5c0d\u8ab0\u505a\u4e8b\u300d&#8211; <code>\/users\/123<\/code> \u5c31\u662f\u300cID 123 \u7684\u4f7f\u7528\u8005\u300d\uff0c\u81f3\u65bc\u300c\u505a\u4ec0\u9ebc\u4e8b\u300d\u7531 HTTP \u65b9\u6cd5\u6c7a\u5b9a\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u539f\u5247 2\uff1aHTTP \u65b9\u6cd5\u7684\u8a9e\u7fa9<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u6bcf\u500b HTTP \u65b9\u6cd5\u90fd\u6709\u56fa\u5b9a\u7684\u542b\u7fa9\uff1a<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table>\n<thead>\n<tr>\n<th>\u65b9\u6cd5<\/th>\n<th>\u505a\u4ec0\u9ebc<\/th>\n<th>\u5b89\u5168\u6027<\/th>\n<th>\u51aa\u7b49\u6027<\/th>\n<th>\u767d\u8a71\u7ffb\u8b6f<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>GET<\/td>\n<td>\u8b80\u53d6\u8cc7\u6599<\/td>\n<td>\u5b89\u5168\uff08\u4e0d\u6539\u8cc7\u6599\uff09<\/td>\n<td>\u51aa\u7b49\uff08\u91cd\u8907\u547c\u53eb\u7d50\u679c\u76f8\u540c\uff09<\/td>\n<td>\u300c\u7d66\u6211\u770b\u770b\u300d<\/td>\n<\/tr>\n<tr>\n<td>POST<\/td>\n<td>\u5efa\u7acb\u65b0\u8cc7\u6599<\/td>\n<td>\u4e0d\u5b89\u5168<\/td>\n<td>\u4e0d\u51aa\u7b49\uff08\u91cd\u8907\u547c\u53eb\u6703\u5efa\u591a\u7b46\uff09<\/td>\n<td>\u300c\u5e6b\u6211\u65b0\u589e\u300d<\/td>\n<\/tr>\n<tr>\n<td>PUT<\/td>\n<td>\u5b8c\u6574\u66f4\u65b0<\/td>\n<td>\u4e0d\u5b89\u5168<\/td>\n<td>\u51aa\u7b49<\/td>\n<td>\u300c\u7528\u9019\u4efd\u8986\u84cb\u6389\u300d<\/td>\n<\/tr>\n<tr>\n<td>PATCH<\/td>\n<td>\u90e8\u5206\u66f4\u65b0<\/td>\n<td>\u4e0d\u5b89\u5168<\/td>\n<td>\u51aa\u7b49<\/td>\n<td>\u300c\u53ea\u6539\u9019\u5e7e\u500b\u6b04\u4f4d\u300d<\/td>\n<\/tr>\n<tr>\n<td>DELETE<\/td>\n<td>\u522a\u9664<\/td>\n<td>\u4e0d\u5b89\u5168<\/td>\n<td>\u51aa\u7b49<\/td>\n<td>\u300c\u5e6b\u6211\u522a\u6389\u300d<\/td>\n<\/tr>\n<\/tbody>\n<\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u4ec0\u9ebc\u662f\u51aa\u7b49\uff1f<\/strong> \u547c\u53eb\u4e00\u6b21\u8ddf\u547c\u53eb\u5341\u6b21\u7684\u7d50\u679c\u4e00\u6a23\u3002DELETE <code>\/users\/123<\/code> \u4e0d\u7ba1\u522a\u5e7e\u6b21\uff0c\u6700\u5f8c\u90a3\u7b46\u90fd\u662f\u88ab\u522a\u9664\u7684\u72c0\u614b\u3002\u4f46 POST <code>\/users<\/code> \u547c\u53eb\u5341\u6b21\u5c31\u6703\u5efa\u51fa\u5341\u7b46\u8cc7\u6599\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u5feb\u901f\u6c7a\u7b56\uff1aPUT \u9084\u662f PATCH\uff1f<\/h3>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">\u8981\u66f4\u65b0\u8cc7\u6599\uff0c\u7528 PUT \u9084\u662f PATCH\uff1f\n\nQ1: \u4f60\u8981\u50b3\u9001\u5b8c\u6574\u7684\u8cc7\u6e90\u5167\u5bb9\u55ce\uff1f\n\u251c\u2500 \u662f\uff08\u5168\u90e8\u6b04\u4f4d\u90fd\u50b3\uff09\u2192 \u7528 PUT\n\u2514\u2500 \u5426\uff08\u53ea\u50b3\u8981\u6539\u7684\u6b04\u4f4d\uff09\u2192 \u7528 PATCH\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u5be6\u52d9\u4e0a\uff0c\u5927\u591a\u6578 AI \u751f\u6210\u7684\u7a0b\u5f0f\u78bc\u90fd\u7528 PATCH \u505a\u90e8\u5206\u66f4\u65b0\uff0c\u9019\u4e5f\u662f\u6bd4\u8f03\u5e38\u898b\u7684\u505a\u6cd5\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u539f\u5247 3\uff1a\u7121\u72c0\u614b<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u6bcf\u500b\u8acb\u6c42\u90fd\u5305\u542b\u8db3\u5920\u7684\u8cc7\u8a0a\uff0c\u4f3a\u670d\u5668\u4e0d\u9700\u8981\u300c\u8a18\u4f4f\u300d\u4e4b\u524d\u7684\u8acb\u6c42\u3002<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-2\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-comment\"># \u597d\u7684\u8a2d\u8a08 -- \u6bcf\u500b\u8acb\u6c42\u5e36\u4e0a\u8eab\u4efd\u9a57\u8b49<\/span>\nGET \/users\/<span class=\"hljs-number\">123<\/span>\nHeaders: Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...\n\n<span class=\"hljs-comment\"># \u4e0d\u597d\u7684\u8a2d\u8a08 -- \u4f9d\u8cf4\u4f3a\u670d\u5668\u8a18\u4f4f\u300c\u4f60\u662f\u8ab0\u300d<\/span>\n<span class=\"hljs-comment\"># \u7b2c\u4e00\u6b65\uff1a\u5148\u767b\u5165\uff08\u4f3a\u670d\u5668\u8a18\u4f4f session\uff09<\/span>\nPOST \/login\n<span class=\"hljs-comment\"># \u7b2c\u4e8c\u6b65\uff1a\u9760 session \u53d6\u8cc7\u6599<\/span>\nGET \/users\/<span class=\"hljs-number\">123<\/span>   <span class=\"hljs-comment\"># \u4f3a\u670d\u5668\u5f9e session \u67e5\u4f60\u662f\u8ab0<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-2\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7ffb\u8b6f<\/strong>\uff1a\u5c31\u50cf\u53bb\u4fbf\u5229\u5546\u5e97\u8cb7\u6771\u897f\uff0c\u6bcf\u6b21\u90fd\u8981\u5e36\u9322\uff08token\uff09\uff0c\u4e0d\u80fd\u8aaa\u300c\u6211\u4e0a\u6b21\u4f86\u904e\uff0c\u8001\u95c6\u4f60\u61c9\u8a72\u8a18\u5f97\u300d\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u8acb\u6c42\u8207\u56de\u61c9\u8a2d\u8a08<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\u7d71\u4e00\u7684 JSON \u56de\u61c9\u7d50\u69cb<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u597d\u7684 API \u56de\u61c9\u683c\u5f0f\u8981\u4e00\u81f4\u3002\u4e0d\u7ba1\u662f\u53d6\u4e00\u7b46\u9084\u662f\u53d6\u591a\u7b46\uff0c\u683c\u5f0f\u90fd\u53ef\u9810\u671f\u3002<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-3\" data-shcb-language-name=\"JSON \/ JSON with Comments\" data-shcb-language-slug=\"json\"><span><code class=\"hljs language-json\"><span class=\"hljs-comment\">\/\/ \u53d6\u5f97\u55ae\u7b46\u8cc7\u6e90\uff1aGET \/users\/123<\/span>\n{\n  <span class=\"hljs-attr\">\"id\"<\/span>: <span class=\"hljs-number\">123<\/span>,\n  <span class=\"hljs-attr\">\"name\"<\/span>: <span class=\"hljs-string\">\"Alice\"<\/span>,\n  <span class=\"hljs-attr\">\"email\"<\/span>: <span class=\"hljs-string\">\"alice@example.com\"<\/span>,\n  <span class=\"hljs-attr\">\"created_at\"<\/span>: <span class=\"hljs-string\">\"2024-01-15T08:30:00Z\"<\/span>\n}\n\n<span class=\"hljs-comment\">\/\/ \u53d6\u5f97\u591a\u7b46\u8cc7\u6e90\uff1aGET \/users<\/span>\n{\n  <span class=\"hljs-attr\">\"data\"<\/span>: &#91;\n    {<span class=\"hljs-attr\">\"id\"<\/span>: <span class=\"hljs-number\">123<\/span>, <span class=\"hljs-attr\">\"name\"<\/span>: <span class=\"hljs-string\">\"Alice\"<\/span>, <span class=\"hljs-attr\">\"email\"<\/span>: <span class=\"hljs-string\">\"alice@example.com\"<\/span>},\n    {<span class=\"hljs-attr\">\"id\"<\/span>: <span class=\"hljs-number\">124<\/span>, <span class=\"hljs-attr\">\"name\"<\/span>: <span class=\"hljs-string\">\"Bob\"<\/span>, <span class=\"hljs-attr\">\"email\"<\/span>: <span class=\"hljs-string\">\"bob@example.com\"<\/span>}\n  ],\n  <span class=\"hljs-attr\">\"pagination\"<\/span>: {\n    <span class=\"hljs-attr\">\"total\"<\/span>: <span class=\"hljs-number\">50<\/span>,\n    <span class=\"hljs-attr\">\"page\"<\/span>: <span class=\"hljs-number\">1<\/span>,\n    <span class=\"hljs-attr\">\"per_page\"<\/span>: <span class=\"hljs-number\">20<\/span>,\n    <span class=\"hljs-attr\">\"total_pages\"<\/span>: <span class=\"hljs-number\">3<\/span>\n  }\n}\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-3\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">JSON \/ JSON with Comments<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">json<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7ffb\u8b6f<\/strong>\uff1a\u591a\u7b46\u8cc7\u6599\u653e\u5728 <code>data<\/code> \u9663\u5217\u88e1\uff0c\u5206\u9801\u8cc7\u8a0a\u653e\u5728 <code>pagination<\/code>\u3002\u524d\u7aef\u62ff\u5230\u5c31\u77e5\u9053\u600e\u9ebc\u8655\u7406\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u5206\u9801\uff1aOffset vs Cursor<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u7576\u8cc7\u6599\u91cf\u5927\u6642\uff0c\u4e0d\u80fd\u4e00\u6b21\u5168\u90e8\u56de\u50b3\uff0c\u9700\u8981\u5206\u9801\u3002\u5169\u7a2e\u4e3b\u6d41\u505a\u6cd5\uff1a<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Offset-based\uff08\u9801\u78bc\u5f0f\uff09<\/strong> &#8212; \u9069\u5408\u5927\u90e8\u5206\u60c5\u6cc1\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">GET \/users?page=2&amp;per_page=20\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7ffb\u8b6f<\/strong>\uff1a\u300c\u7d66\u6211\u7b2c 2 \u9801\uff0c\u6bcf\u9801 20 \u7b46\u300d\u3002\u7c21\u55ae\u76f4\u89ba\uff0c\u4f46\u8cc7\u6599\u91cf\u5f88\u5927\u6642\u6548\u80fd\u6703\u8b8a\u5dee\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Cursor-based\uff08\u6e38\u6a19\u5f0f\uff09<\/strong> &#8212; \u9069\u5408\u5927\u91cf\u8cc7\u6599\u6216\u5373\u6642\u52d5\u614b\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">GET \/users?cursor=eyJpZCI6MTIzfQ&amp;limit=20\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7ffb\u8b6f<\/strong>\uff1a\u300c\u5f9e\u4e0a\u6b21\u7684\u4f4d\u7f6e\u7e7c\u7e8c\u5f80\u4e0b\u7d66\u6211 20 \u7b46\u300d\u3002\u6548\u80fd\u597d\uff0c\u4f46\u6c92\u8fa6\u6cd5\u8df3\u9801\u3002<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table>\n<thead>\n<tr>\n<th>\u60c5\u5883<\/th>\n<th>\u5efa\u8b70\u9078\u64c7<\/th>\n<th>\u539f\u56e0<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>\u5f8c\u53f0\u7ba1\u7406\u9801\u9762<\/td>\n<td>Offset<\/td>\n<td>\u4f7f\u7528\u8005\u9700\u8981\u8df3\u5230\u7279\u5b9a\u9801<\/td>\n<\/tr>\n<tr>\n<td>\u793e\u7fa4\u52d5\u614b\u7246<\/td>\n<td>Cursor<\/td>\n<td>\u8cc7\u6599\u6301\u7e8c\u65b0\u589e\uff0coffset \u6703\u91cd\u8907<\/td>\n<\/tr>\n<tr>\n<td>\u8cc7\u6599\u91cf < 10 \u842c<\/td>\n<td>Offset<\/td>\n<td>\u7c21\u55ae\u597d\u5be6\u4f5c<\/td>\n<\/tr>\n<tr>\n<td>\u8cc7\u6599\u91cf > \u767e\u842c<\/td>\n<td>Cursor<\/td>\n<td>Offset \u5728\u5927\u91cf\u8cc7\u6599\u6642\u6703\u8b8a\u6162<\/td>\n<\/tr>\n<\/tbody>\n<\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">\u904e\u6ffe\u8207\u6392\u5e8f<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u8b93\u524d\u7aef\u53ef\u4ee5\u5f48\u6027\u67e5\u8a62\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-4\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-comment\"># \u904e\u6ffe\uff1a\u53ea\u8981\u6d3b\u8e8d\u7684\u4f7f\u7528\u8005<\/span>\nGET \/users?status=active\n\n<span class=\"hljs-comment\"># \u6392\u5e8f\uff1a\u6309\u5efa\u7acb\u6642\u9593\u5012\u5e8f<\/span>\nGET \/users?sort=-created_at\n\n<span class=\"hljs-comment\"># \u7d44\u5408\u4f7f\u7528<\/span>\nGET \/users?status=active&amp;sort=-created_at&amp;page=<span class=\"hljs-number\">1<\/span>&amp;per_page=<span class=\"hljs-number\">20<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-4\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7ffb\u8b6f<\/strong>\uff1a<code>sort=-created_at<\/code> \u7684 <code>-<\/code> \u4ee3\u8868\u964d\u5e8f\uff08\u6700\u65b0\u7684\u5728\u524d\u9762\uff09\uff0c\u6c92\u6709 <code>-<\/code> \u5c31\u662f\u5347\u5e8f\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u932f\u8aa4\u8655\u7406\u6a21\u5f0f<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">HTTP \u72c0\u614b\u78bc\u8a9e\u7fa9<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u72c0\u614b\u78bc\u544a\u8a34\u4f60\u300c\u9019\u6b21\u8acb\u6c42\u7684\u7d50\u679c\u5982\u4f55\u300d\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-5\" data-shcb-language-name=\"JavaScript\" data-shcb-language-slug=\"javascript\"><span><code class=\"hljs language-javascript\"><span class=\"hljs-number\">2<\/span>xx -- \u6210\u529f\n  <span class=\"hljs-number\">200<\/span> OK          \u2192 \u4e00\u822c\u6210\u529f\n  <span class=\"hljs-number\">201<\/span> Created     \u2192 \u6210\u529f\u5efa\u7acb\u65b0\u8cc7\u6e90\n  <span class=\"hljs-number\">204<\/span> No Content  \u2192 \u6210\u529f\uff0c\u4f46\u6c92\u6709\u8981\u56de\u50b3\u7684\u5167\u5bb9\uff08\u5e38\u898b\u65bc DELETE\uff09\n\n<span class=\"hljs-number\">4<\/span>xx -- \u7528\u6236\u7aef\u932f\u8aa4\uff08\u4f60\u7684\u554f\u984c\uff09\n  <span class=\"hljs-number\">400<\/span> Bad Request    \u2192 \u8acb\u6c42\u683c\u5f0f\u4e0d\u5c0d\n  <span class=\"hljs-number\">401<\/span> Unauthorized   \u2192 \u6c92\u6709\u767b\u5165\uff08\u8eab\u4efd\u9a57\u8b49\u5931\u6557\uff09\n  <span class=\"hljs-number\">403<\/span> Forbidden      \u2192 \u6709\u767b\u5165\u4f46\u6c92\u6709\u6b0a\u9650\n  <span class=\"hljs-number\">404<\/span> Not Found      \u2192 \u8cc7\u6e90\u4e0d\u5b58\u5728\n  <span class=\"hljs-number\">409<\/span> Conflict       \u2192 \u8cc7\u6e90\u885d\u7a81\uff08\u4f8b\u5982 email \u5df2\u88ab\u8a3b\u518a\uff09\n  <span class=\"hljs-number\">422<\/span> Unprocessable  \u2192 \u683c\u5f0f\u5c0d\u4f46\u5167\u5bb9\u4e0d\u5408\u7406\uff08\u4f8b\u5982\u5e74\u9f61\u662f\u8ca0\u6578\uff09\n\n<span class=\"hljs-number\">5<\/span>xx -- \u4f3a\u670d\u5668\u932f\u8aa4\uff08\u4e0d\u662f\u4f60\u7684\u554f\u984c\uff09\n  <span class=\"hljs-number\">500<\/span> Internal Server <span class=\"hljs-built_in\">Error<\/span> \u2192 \u4f3a\u670d\u5668\u58de\u4e86\n  <span class=\"hljs-number\">503<\/span> Service Unavailable   \u2192 \u4f3a\u670d\u5668\u66ab\u6642\u5fd9\u4e0d\u904e\u4f86\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-5\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">JavaScript<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">javascript<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5feb\u901f\u5224\u65b7<\/strong>\uff1a\u770b\u5230 4xx \u5148\u6aa2\u67e5\u4f60\u7684\u8acb\u6c42\uff0c\u770b\u5230 5xx \u5c31\u662f\u5f8c\u7aef\u6709\u554f\u984c\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u7d71\u4e00\u932f\u8aa4\u683c\u5f0f<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u597d\u7684 API \u4e0d\u53ea\u56de\u50b3\u72c0\u614b\u78bc\uff0c\u9084\u6703\u56de\u50b3\u7d50\u69cb\u5316\u7684\u932f\u8aa4\u8a0a\u606f\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-6\" data-shcb-language-name=\"JSON \/ JSON with Comments\" data-shcb-language-slug=\"json\"><span><code class=\"hljs language-json\"><span class=\"hljs-comment\">\/\/ 422 Unprocessable Entity<\/span>\n{\n  <span class=\"hljs-attr\">\"error\"<\/span>: {\n    <span class=\"hljs-attr\">\"code\"<\/span>: <span class=\"hljs-string\">\"VALIDATION_ERROR\"<\/span>,\n    <span class=\"hljs-attr\">\"message\"<\/span>: <span class=\"hljs-string\">\"\u8f38\u5165\u8cc7\u6599\u9a57\u8b49\u5931\u6557\"<\/span>,\n    <span class=\"hljs-attr\">\"details\"<\/span>: &#91;\n      {\n        <span class=\"hljs-attr\">\"field\"<\/span>: <span class=\"hljs-string\">\"email\"<\/span>,\n        <span class=\"hljs-attr\">\"message\"<\/span>: <span class=\"hljs-string\">\"email \u683c\u5f0f\u4e0d\u6b63\u78ba\"<\/span>\n      },\n      {\n        <span class=\"hljs-attr\">\"field\"<\/span>: <span class=\"hljs-string\">\"age\"<\/span>,\n        <span class=\"hljs-attr\">\"message\"<\/span>: <span class=\"hljs-string\">\"\u5e74\u9f61\u5fc5\u9808\u5927\u65bc 0\"<\/span>\n      }\n    ]\n  }\n}\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-6\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">JSON \/ JSON with Comments<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">json<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u9019\u500b\u7d50\u69cb\u7684\u597d\u8655<\/strong>\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><code>code<\/code>\uff1a\u7a0b\u5f0f\u53ef\u4ee5\u7528\u4f86\u5224\u65b7\u932f\u8aa4\u985e\u578b<\/li>\n\n\n<li><code>message<\/code>\uff1a\u4eba\u53ef\u4ee5\u8b80\u7684\u63cf\u8ff0<\/li>\n\n\n<li><code>details<\/code>\uff1a\u5177\u9ad4\u54ea\u88e1\u51fa\u932f\uff0c\u524d\u7aef\u53ef\u4ee5\u6a19\u793a\u5728\u5c0d\u61c9\u7684\u6b04\u4f4d\u4e0a<\/li>\n\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">API \u7248\u672c\u63a7\u5236<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u7cfb\u7d71\u6703\u6210\u9577\uff0cAPI \u4e5f\u9700\u8981\u6539\u7248\u3002\u4f46\u820a\u7684\u7528\u6236\u7aef\u53ef\u80fd\u9084\u5728\u7528\u820a\u7248 API\uff0c\u600e\u9ebc\u8fa6\uff1f<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u5169\u7a2e\u4e3b\u6d41\u505a\u6cd5<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>URL Path Versioning\uff08\u8def\u5f91\u7248\u672c\uff09<\/strong> &#8212; \u6700\u5e38\u898b\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">GET \/v1\/users\/123\nGET \/v2\/users\/123\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>Header Versioning\uff08\u6a19\u982d\u7248\u672c\uff09<\/strong>\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">GET \/users\/123\nHeaders: API-Version: 2\n<\/code><\/span><\/pre><\/div>\n\n\n<figure class=\"wp-block-table\"><table>\n<thead>\n<tr>\n<th>\u505a\u6cd5<\/th>\n<th>\u512a\u9ede<\/th>\n<th>\u7f3a\u9ede<\/th>\n<th>\u9069\u5408\u5834\u666f<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>URL \u8def\u5f91<\/td>\n<td>\u4e00\u773c\u5c31\u77e5\u9053\u7248\u672c\uff0c\u597d\u6e2c\u8a66<\/td>\n<td>URL \u9577\u4e86\u4e00\u7bc0<\/td>\n<td>\u516c\u958b API\u3001\u5927\u90e8\u5206\u60c5\u6cc1<\/td>\n<\/tr>\n<tr>\n<td>Header<\/td>\n<td>URL \u4e7e\u6de8<\/td>\n<td>\u4e0d\u5bb9\u6613\u770b\u51fa\u7248\u672c<\/td>\n<td>\u5167\u90e8 API<\/td>\n<\/tr>\n<\/tbody>\n<\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5be6\u52d9\u5efa\u8b70<\/strong>\uff1a\u7528 URL \u8def\u5f91\u7248\u672c\u5c31\u5c0d\u4e86\u3002\u7c21\u55ae\u3001\u76f4\u89ba\u3001\u5927\u5bb6\u90fd\u770b\u5f97\u61c2\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u4ec0\u9ebc\u6642\u5019\u8981\u5347\u7248\uff1f<\/h3>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">\u4e0d\u9700\u8981\u5347\u7248\uff08\u5411\u5f8c\u76f8\u5bb9\u7684\u4fee\u6539\uff09\uff1a\n  - \u65b0\u589e\u6b04\u4f4d\n  - \u65b0\u589e endpoint\n  - \u65b0\u589e\u53ef\u9078\u7684 query parameter\n\n\u9700\u8981\u5347\u7248\uff08\u7834\u58de\u6027\u4fee\u6539\uff09\uff1a\n  - \u522a\u9664\u6216\u91cd\u65b0\u547d\u540d\u6b04\u4f4d\n  - \u6539\u8b8a\u6b04\u4f4d\u7684\u8cc7\u6599\u578b\u5225\n  - \u6539\u8b8a\u5fc5\u8981\u53c3\u6578\n  - \u6539\u8b8a\u56de\u61c9\u7d50\u69cb\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7ffb\u8b6f<\/strong>\uff1a\u300c\u52a0\u6771\u897f\u300d\u4e0d\u7528\u5347\u7248\uff0c\u300c\u6539\u6771\u897f\u300d\u6216\u300c\u522a\u6771\u897f\u300d\u624d\u8981\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u8a8d\u8b49\u8207\u6388\u6b0a\u57fa\u790e<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">API \u8981\u4fdd\u8b77\u8d77\u4f86\uff0c\u4e0d\u662f\u8ab0\u90fd\u80fd\u547c\u53eb\u7684\u3002\u5169\u500b\u6838\u5fc3\u6982\u5ff5\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>\u8a8d\u8b49\uff08Authentication\uff09<\/strong>\uff1a\u300c\u4f60\u662f\u8ab0\uff1f\u300d&#8211; \u8b49\u660e\u4f60\u7684\u8eab\u4efd<\/li>\n\n\n<li><strong>\u6388\u6b0a\uff08Authorization\uff09<\/strong>\uff1a\u300c\u4f60\u80fd\u505a\u4ec0\u9ebc\uff1f\u300d&#8211; \u6aa2\u67e5\u4f60\u7684\u6b0a\u9650<\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">\u5169\u7a2e\u5e38\u898b\u65b9\u6848<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>API Key<\/strong> &#8212; \u7c21\u55ae\u4f46\u529f\u80fd\u6709\u9650\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">GET \/users\nHeaders: X-API-Key: sk_live_abc123def456\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7ffb\u8b6f<\/strong>\uff1a\u5c31\u50cf\u4e00\u628a\u9470\u5319\uff0c\u6709\u9470\u5319\u5c31\u80fd\u9032\u9580\u3002\u9069\u5408\u670d\u52d9\u4e4b\u9593\u7684\u901a\u8a0a\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>JWT Token<\/strong> &#8212; \u76ee\u524d\u6700\u4e3b\u6d41\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">GET \/users\nHeaders: Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxMjN9.xxx\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7ffb\u8b6f<\/strong>\uff1aToken \u88e1\u9762\u85cf\u4e86\u300c\u4f60\u662f\u8ab0\u300d\u7684\u8cc7\u8a0a\uff0c\u4f3a\u670d\u5668\u89e3\u958b\u5c31\u77e5\u9053\u3002\u9069\u5408\u524d\u5f8c\u7aef\u5206\u96e2\u7684\u4f7f\u7528\u8005\u8a8d\u8b49\u3002<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table>\n<thead>\n<tr>\n<th>\u65b9\u6848<\/th>\n<th>\u9069\u5408\u5834\u666f<\/th>\n<th>\u7279\u9ede<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>API Key<\/td>\n<td>\u5f8c\u7aef\u670d\u52d9\u4e4b\u9593\u3001\u7b2c\u4e09\u65b9 API<\/td>\n<td>\u7c21\u55ae\uff0c\u4e0d\u904e\u671f\uff08\u9664\u975e\u4e3b\u52d5\u64a4\u92b7\uff09<\/td>\n<\/tr>\n<tr>\n<td>JWT Token<\/td>\n<td>\u4f7f\u7528\u8005\u767b\u5165\u3001\u524d\u5f8c\u7aef\u5206\u96e2<\/td>\n<td>\u5e36\u6709\u4f7f\u7528\u8005\u8cc7\u8a0a\uff0c\u6703\u904e\u671f<\/td>\n<\/tr>\n<\/tbody>\n<\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u5be6\u4f5c\u7bc4\u4f8b\uff1a\u7528 FastAPI \u6253\u9020\u5f85\u8fa6\u4e8b\u9805 API<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u4f86\u770b\u4e00\u500b\u5b8c\u6574\u7684\u7bc4\u4f8b\uff0c\u628a\u4ee5\u4e0a\u6240\u6709\u539f\u5247\u7528\u5728\u4e00\u500b\u300c\u5f85\u8fa6\u4e8b\u9805 API\u300d\u4e0a\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u5f8c\u7aef\uff1aFastAPI \u5be6\u4f5c<\/h3>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">from fastapi import FastAPI, HTTPException, Query\nfrom pydantic import BaseModel\nfrom datetime import datetime\n\napp = FastAPI()  # \u5efa\u7acb API \u61c9\u7528\u7a0b\u5f0f\n\n# --- \u8cc7\u6599\u6a21\u578b\uff08\u5b9a\u7fa9\u8cc7\u6599\u9577\u4ec0\u9ebc\u6a23\uff09---\n\nclass TodoCreate(BaseModel):  # \u5efa\u7acb\u5f85\u8fa6\u4e8b\u9805\u6642\u8981\u50b3\u4ec0\u9ebc\n    title: str                # \u5fc5\u586b\uff1a\u6a19\u984c\uff08\u6587\u5b57\uff09\n    description: str = \"\"     # \u9078\u586b\uff1a\u63cf\u8ff0\uff08\u9810\u8a2d\u7a7a\u5b57\u4e32\uff09\n\nclass TodoUpdate(BaseModel):  # \u66f4\u65b0\u6642\u53ef\u4ee5\u53ea\u50b3\u8981\u6539\u7684\u6b04\u4f4d\n    title: str | None = None\n    description: str | None = None\n    completed: bool | None = None\n\nclass Todo(BaseModel):        # \u5b8c\u6574\u7684\u5f85\u8fa6\u4e8b\u9805\u7d50\u69cb\n    id: int\n    title: str\n    description: str\n    completed: bool\n    created_at: datetime\n\nclass ErrorDetail(BaseModel):\n    code: str\n    message: str\n    details: list = &#91;]\n\nclass ErrorResponse(BaseModel):  # \u7d71\u4e00\u7684\u932f\u8aa4\u683c\u5f0f\n    error: ErrorDetail\n\n# --- \u6a21\u64ec\u8cc7\u6599\u5eab ---\ntodos_db: dict&#91;int, Todo] = {}\nnext_id = 1\n\n# --- API Endpoints ---\n\n# \u53d6\u5f97\u6240\u6709\u5f85\u8fa6\u4e8b\u9805\uff08\u652f\u63f4\u904e\u6ffe\u3001\u5206\u9801\uff09\n@app.get(\"\/v1\/todos\")\ndef list_todos(\n    completed: bool | None = None,           # \u904e\u6ffe\uff1a\u662f\u5426\u5b8c\u6210\n    sort: str = \"-created_at\",               # \u6392\u5e8f\uff1a\u9810\u8a2d\u6700\u65b0\u5728\u524d\n    page: int = Query(default=1, ge=1),      # \u5206\u9801\uff1a\u7b2c\u5e7e\u9801\uff08\u6700\u5c0f 1\uff09\n    per_page: int = Query(default=20, le=100) # \u6bcf\u9801\u5e7e\u7b46\uff08\u6700\u591a 100\uff09\n):\n    items = list(todos_db.values())\n\n    # \u904e\u6ffe\n    if completed is not None:\n        items = &#91;t for t in items if t.completed == completed]\n\n    # \u6392\u5e8f\n    reverse = sort.startswith(\"-\")\n    sort_field = sort.lstrip(\"-\")\n    items.sort(key=lambda t: getattr(t, sort_field), reverse=reverse)\n\n    # \u5206\u9801\n    total = len(items)\n    start = (page - 1) * per_page\n    items = items&#91;start:start + per_page]\n\n    return {\n        \"data\": items,\n        \"pagination\": {\n            \"total\": total,\n            \"page\": page,\n            \"per_page\": per_page,\n            \"total_pages\": (total + per_page - 1) \/\/ per_page\n        }\n    }\n\n# \u53d6\u5f97\u55ae\u7b46\u5f85\u8fa6\u4e8b\u9805\n@app.get(\"\/v1\/todos\/{todo_id}\")\ndef get_todo(todo_id: int):\n    if todo_id not in todos_db:\n        raise HTTPException(\n            status_code=404,\n            detail={\n                \"error\": {\n                    \"code\": \"NOT_FOUND\",\n                    \"message\": f\"\u5f85\u8fa6\u4e8b\u9805 {todo_id} \u4e0d\u5b58\u5728\"\n                }\n            }\n        )\n    return todos_db&#91;todo_id]\n\n# \u5efa\u7acb\u5f85\u8fa6\u4e8b\u9805\n@app.post(\"\/v1\/todos\", status_code=201)  # 201 = Created\ndef create_todo(todo: TodoCreate):\n    global next_id\n    new_todo = Todo(\n        id=next_id,\n        title=todo.title,\n        description=todo.description,\n        completed=False,\n        created_at=datetime.now()\n    )\n    todos_db&#91;next_id] = new_todo\n    next_id += 1\n    return new_todo\n\n# \u90e8\u5206\u66f4\u65b0\u5f85\u8fa6\u4e8b\u9805\n@app.patch(\"\/v1\/todos\/{todo_id}\")\ndef update_todo(todo_id: int, updates: TodoUpdate):\n    if todo_id not in todos_db:\n        raise HTTPException(\n            status_code=404,\n            detail={\n                \"error\": {\n                    \"code\": \"NOT_FOUND\",\n                    \"message\": f\"\u5f85\u8fa6\u4e8b\u9805 {todo_id} \u4e0d\u5b58\u5728\"\n                }\n            }\n        )\n    existing = todos_db&#91;todo_id]\n    update_data = updates.model_dump(exclude_unset=True)  # \u53ea\u53d6\u6709\u50b3\u7684\u6b04\u4f4d\n    updated = existing.model_copy(update=update_data)\n    todos_db&#91;todo_id] = updated\n    return updated\n\n# \u522a\u9664\u5f85\u8fa6\u4e8b\u9805\n@app.delete(\"\/v1\/todos\/{todo_id}\", status_code=204)  # 204 = No Content\ndef delete_todo(todo_id: int):\n    if todo_id not in todos_db:\n        raise HTTPException(\n            status_code=404,\n            detail={\n                \"error\": {\n                    \"code\": \"NOT_FOUND\",\n                    \"message\": f\"\u5f85\u8fa6\u4e8b\u9805 {todo_id} \u4e0d\u5b58\u5728\"\n                }\n            }\n        )\n    del todos_db&#91;todo_id]\n<\/code><\/span><\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">\u9010\u884c\u7ffb\u8b6f\u91cd\u9ede<\/h3>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-7\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">@app.get(<span class=\"hljs-string\">\"\/v1\/todos\"<\/span>)            <span class=\"hljs-comment\"># \u7576\u6709\u4eba\u7528 GET \u65b9\u6cd5\u8a2a\u554f \/v1\/todos \u6642\u57f7\u884c<\/span>\ndef list_todos(\n    completed: bool | None = None,  <span class=\"hljs-comment\"># \u53ef\u9078\u53c3\u6578\uff0cFastAPI \u81ea\u52d5\u5f9e ?completed=true \u53d6\u503c<\/span>\n    page: int = Query(<span class=\"hljs-keyword\">default<\/span>=<span class=\"hljs-number\">1<\/span>, ge=<span class=\"hljs-number\">1<\/span>),  <span class=\"hljs-comment\"># Query() \u52a0\u4e0a\u9a57\u8b49\uff1a\u6700\u5c0f\u503c 1<\/span>\n):\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-7\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-8\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">raise HTTPException(status_code=<span class=\"hljs-number\">404<\/span>, detail={...})\n<span class=\"hljs-comment\"># \u2191 \u62cb\u51fa HTTP \u932f\u8aa4\uff0cFastAPI \u6703\u81ea\u52d5\u56de\u50b3 404 \u72c0\u614b\u78bc + \u932f\u8aa4\u5167\u5bb9<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-8\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-9\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">updates.model_dump(exclude_unset=<span class=\"hljs-keyword\">True<\/span>)\n<span class=\"hljs-comment\"># \u2191 \u53ea\u53d6\u51fa\u300c\u6709\u50b3\u7684\u6b04\u4f4d\u300d\uff0c\u6c92\u50b3\u7684\u4e0d\u7b97<\/span>\n<span class=\"hljs-comment\"># \u4f8b\u5982\u53ea\u50b3 {\"completed\": true}\uff0c\u5c31\u53ea\u6703\u66f4\u65b0 completed<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-9\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-10\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">existing.model_copy(update=update_data)\n<span class=\"hljs-comment\"># \u2191 \u7528\u65b0\u8cc7\u6599\u8986\u84cb\u820a\u8cc7\u6599\u7684\u5c0d\u61c9\u6b04\u4f4d\uff0c\u5176\u4ed6\u6b04\u4f4d\u4fdd\u6301\u4e0d\u8b8a<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-10\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">\u524d\u7aef\uff1aReact \u6d88\u8cbb API<\/h3>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-11\" data-shcb-language-name=\"JavaScript\" data-shcb-language-slug=\"javascript\"><span><code class=\"hljs language-javascript\"><span class=\"hljs-comment\">\/\/ api.js -- API \u547c\u53eb\u51fd\u5f0f<\/span>\n\n<span class=\"hljs-keyword\">const<\/span> API_BASE = <span class=\"hljs-string\">\"\/v1\"<\/span>;\n\n<span class=\"hljs-comment\">\/\/ \u53d6\u5f97\u5f85\u8fa6\u4e8b\u9805\u5217\u8868\uff08\u5e36\u5206\u9801\u548c\u904e\u6ffe\uff09<\/span>\n<span class=\"hljs-keyword\">async<\/span> <span class=\"hljs-function\"><span class=\"hljs-keyword\">function<\/span> <span class=\"hljs-title\">listTodos<\/span>(<span class=\"hljs-params\">{ page = <span class=\"hljs-number\">1<\/span>, completed = null } = {}<\/span>) <\/span>{\n  <span class=\"hljs-keyword\">const<\/span> params = <span class=\"hljs-keyword\">new<\/span> URLSearchParams({ page, <span class=\"hljs-attr\">per_page<\/span>: <span class=\"hljs-number\">20<\/span> });\n  <span class=\"hljs-keyword\">if<\/span> (completed !== <span class=\"hljs-literal\">null<\/span>) params.set(<span class=\"hljs-string\">\"completed\"<\/span>, completed);\n\n  <span class=\"hljs-keyword\">const<\/span> res = <span class=\"hljs-keyword\">await<\/span> fetch(<span class=\"hljs-string\">`<span class=\"hljs-subst\">${API_BASE}<\/span>\/todos?<span class=\"hljs-subst\">${params}<\/span>`<\/span>);\n  <span class=\"hljs-keyword\">if<\/span> (!res.ok) {\n    <span class=\"hljs-keyword\">const<\/span> error = <span class=\"hljs-keyword\">await<\/span> res.json();    <span class=\"hljs-comment\">\/\/ \u89e3\u6790\u932f\u8aa4\u56de\u61c9<\/span>\n    <span class=\"hljs-keyword\">throw<\/span> <span class=\"hljs-keyword\">new<\/span> <span class=\"hljs-built_in\">Error<\/span>(error.error.message);\n  }\n  <span class=\"hljs-keyword\">return<\/span> res.json();  <span class=\"hljs-comment\">\/\/ { data: &#91;...], pagination: {...} }<\/span>\n}\n\n<span class=\"hljs-comment\">\/\/ \u5efa\u7acb\u5f85\u8fa6\u4e8b\u9805<\/span>\n<span class=\"hljs-keyword\">async<\/span> <span class=\"hljs-function\"><span class=\"hljs-keyword\">function<\/span> <span class=\"hljs-title\">createTodo<\/span>(<span class=\"hljs-params\">title, description = <span class=\"hljs-string\">\"\"<\/span><\/span>) <\/span>{\n  <span class=\"hljs-keyword\">const<\/span> res = <span class=\"hljs-keyword\">await<\/span> fetch(<span class=\"hljs-string\">`<span class=\"hljs-subst\">${API_BASE}<\/span>\/todos`<\/span>, {\n    <span class=\"hljs-attr\">method<\/span>: <span class=\"hljs-string\">\"POST\"<\/span>,                          <span class=\"hljs-comment\">\/\/ \u5efa\u7acb\u7528 POST<\/span>\n    <span class=\"hljs-attr\">headers<\/span>: { <span class=\"hljs-string\">\"Content-Type\"<\/span>: <span class=\"hljs-string\">\"application\/json\"<\/span> },\n    <span class=\"hljs-attr\">body<\/span>: <span class=\"hljs-built_in\">JSON<\/span>.stringify({ title, description }),\n  });\n  <span class=\"hljs-keyword\">if<\/span> (!res.ok) {\n    <span class=\"hljs-keyword\">const<\/span> error = <span class=\"hljs-keyword\">await<\/span> res.json();\n    <span class=\"hljs-keyword\">throw<\/span> <span class=\"hljs-keyword\">new<\/span> <span class=\"hljs-built_in\">Error<\/span>(error.error.message);\n  }\n  <span class=\"hljs-keyword\">return<\/span> res.json();\n}\n\n<span class=\"hljs-comment\">\/\/ \u66f4\u65b0\u5f85\u8fa6\u4e8b\u9805\uff08\u90e8\u5206\u66f4\u65b0\uff09<\/span>\n<span class=\"hljs-keyword\">async<\/span> <span class=\"hljs-function\"><span class=\"hljs-keyword\">function<\/span> <span class=\"hljs-title\">updateTodo<\/span>(<span class=\"hljs-params\">id, updates<\/span>) <\/span>{\n  <span class=\"hljs-keyword\">const<\/span> res = <span class=\"hljs-keyword\">await<\/span> fetch(<span class=\"hljs-string\">`<span class=\"hljs-subst\">${API_BASE}<\/span>\/todos\/<span class=\"hljs-subst\">${id}<\/span>`<\/span>, {\n    <span class=\"hljs-attr\">method<\/span>: <span class=\"hljs-string\">\"PATCH\"<\/span>,                         <span class=\"hljs-comment\">\/\/ \u90e8\u5206\u66f4\u65b0\u7528 PATCH<\/span>\n    <span class=\"hljs-attr\">headers<\/span>: { <span class=\"hljs-string\">\"Content-Type\"<\/span>: <span class=\"hljs-string\">\"application\/json\"<\/span> },\n    <span class=\"hljs-attr\">body<\/span>: <span class=\"hljs-built_in\">JSON<\/span>.stringify(updates),           <span class=\"hljs-comment\">\/\/ \u53ea\u50b3\u8981\u6539\u7684\u6b04\u4f4d<\/span>\n  });\n  <span class=\"hljs-keyword\">if<\/span> (!res.ok) {\n    <span class=\"hljs-keyword\">const<\/span> error = <span class=\"hljs-keyword\">await<\/span> res.json();\n    <span class=\"hljs-keyword\">throw<\/span> <span class=\"hljs-keyword\">new<\/span> <span class=\"hljs-built_in\">Error<\/span>(error.error.message);\n  }\n  <span class=\"hljs-keyword\">return<\/span> res.json();\n}\n\n<span class=\"hljs-comment\">\/\/ \u522a\u9664\u5f85\u8fa6\u4e8b\u9805<\/span>\n<span class=\"hljs-keyword\">async<\/span> <span class=\"hljs-function\"><span class=\"hljs-keyword\">function<\/span> <span class=\"hljs-title\">deleteTodo<\/span>(<span class=\"hljs-params\">id<\/span>) <\/span>{\n  <span class=\"hljs-keyword\">const<\/span> res = <span class=\"hljs-keyword\">await<\/span> fetch(<span class=\"hljs-string\">`<span class=\"hljs-subst\">${API_BASE}<\/span>\/todos\/<span class=\"hljs-subst\">${id}<\/span>`<\/span>, {\n    <span class=\"hljs-attr\">method<\/span>: <span class=\"hljs-string\">\"DELETE\"<\/span>,\n  });\n  <span class=\"hljs-keyword\">if<\/span> (!res.ok &amp;&amp; res.status !== <span class=\"hljs-number\">204<\/span>) {\n    <span class=\"hljs-keyword\">const<\/span> error = <span class=\"hljs-keyword\">await<\/span> res.json();\n    <span class=\"hljs-keyword\">throw<\/span> <span class=\"hljs-keyword\">new<\/span> <span class=\"hljs-built_in\">Error<\/span>(error.error.message);\n  }\n  <span class=\"hljs-comment\">\/\/ DELETE \u6210\u529f\u56de\u50b3 204\uff0c\u6c92\u6709 body<\/span>\n}\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-11\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">JavaScript<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">javascript<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-12\" data-shcb-language-name=\"JavaScript\" data-shcb-language-slug=\"javascript\"><span><code class=\"hljs language-javascript\"><span class=\"hljs-comment\">\/\/ TodoList.jsx -- React \u5143\u4ef6\u4f7f\u7528 API<\/span>\n\n<span class=\"hljs-keyword\">import<\/span> { useState, useEffect } <span class=\"hljs-keyword\">from<\/span> <span class=\"hljs-string\">\"react\"<\/span>;\n\n<span class=\"hljs-function\"><span class=\"hljs-keyword\">function<\/span> <span class=\"hljs-title\">TodoList<\/span>(<span class=\"hljs-params\"><\/span>) <\/span>{\n  <span class=\"hljs-keyword\">const<\/span> &#91;todos, setTodos] = useState(&#91;]);\n  <span class=\"hljs-keyword\">const<\/span> &#91;pagination, setPagination] = useState(<span class=\"hljs-literal\">null<\/span>);\n  <span class=\"hljs-keyword\">const<\/span> &#91;page, setPage] = useState(<span class=\"hljs-number\">1<\/span>);\n\n  <span class=\"hljs-comment\">\/\/ \u8f09\u5165\u5f85\u8fa6\u4e8b\u9805<\/span>\n  useEffect(<span class=\"hljs-function\"><span class=\"hljs-params\">()<\/span> =&gt;<\/span> {\n    listTodos({ page }).then(<span class=\"hljs-function\">(<span class=\"hljs-params\">result<\/span>) =&gt;<\/span> {\n      setTodos(result.data);             <span class=\"hljs-comment\">\/\/ API \u56de\u50b3\u7684 data \u9663\u5217<\/span>\n      setPagination(result.pagination);  <span class=\"hljs-comment\">\/\/ API \u56de\u50b3\u7684\u5206\u9801\u8cc7\u8a0a<\/span>\n    });\n  }, &#91;page]);\n\n  <span class=\"hljs-comment\">\/\/ \u5207\u63db\u5b8c\u6210\u72c0\u614b<\/span>\n  <span class=\"hljs-keyword\">async<\/span> <span class=\"hljs-function\"><span class=\"hljs-keyword\">function<\/span> <span class=\"hljs-title\">toggleComplete<\/span>(<span class=\"hljs-params\">todo<\/span>) <\/span>{\n    <span class=\"hljs-keyword\">const<\/span> updated = <span class=\"hljs-keyword\">await<\/span> updateTodo(todo.id, {\n      <span class=\"hljs-attr\">completed<\/span>: !todo.completed,        <span class=\"hljs-comment\">\/\/ \u53ea\u50b3 completed \u6b04\u4f4d<\/span>\n    });\n    setTodos(todos.map(<span class=\"hljs-function\">(<span class=\"hljs-params\">t<\/span>) =&gt;<\/span> (t.id === updated.id ? updated : t)));\n  }\n\n  <span class=\"hljs-keyword\">return<\/span> (\n    <span class=\"xml\"><span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">div<\/span>&gt;<\/span>\n      {todos.map((todo) =&gt; (\n        <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">div<\/span> <span class=\"hljs-attr\">key<\/span>=<span class=\"hljs-string\">{todo.id}<\/span>&gt;<\/span>\n          <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">span<\/span>&gt;<\/span>{todo.title}<span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">span<\/span>&gt;<\/span>\n          <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">button<\/span> <span class=\"hljs-attr\">onClick<\/span>=<span class=\"hljs-string\">{()<\/span> =&gt;<\/span> toggleComplete(todo)}&gt;\n            {todo.completed ? \"\u53d6\u6d88\u5b8c\u6210\" : \"\u5b8c\u6210\"}\n          <span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">button<\/span>&gt;<\/span>\n        <span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">div<\/span>&gt;<\/span>\n      ))}\n      {pagination &amp;&amp; (\n        <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">div<\/span>&gt;<\/span>\n          \u7b2c {pagination.page} \/ {pagination.total_pages} \u9801\n          <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">button<\/span> <span class=\"hljs-attr\">disabled<\/span>=<span class=\"hljs-string\">{page<\/span> &lt;= <span class=\"hljs-string\">1}<\/span> <span class=\"hljs-attr\">onClick<\/span>=<span class=\"hljs-string\">{()<\/span> =&gt;<\/span> setPage(page - 1)}&gt;\n            \u4e0a\u4e00\u9801\n          <span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">button<\/span>&gt;<\/span>\n          <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">button<\/span>\n            <span class=\"hljs-attr\">disabled<\/span>=<span class=\"hljs-string\">{page<\/span> &gt;<\/span>= pagination.total_pages}\n            onClick={() =&gt; setPage(page + 1)}\n          &gt;\n            \u4e0b\u4e00\u9801\n          <span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">button<\/span>&gt;<\/span>\n        <span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">div<\/span>&gt;<\/span>\n      )}\n    <span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">div<\/span>&gt;<\/span><\/span>\n  );\n}\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-12\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">JavaScript<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">javascript<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><strong>\u9019\u5c31\u662f\u300c\u5951\u7d04\u300d\u7684\u9ad4\u73fe<\/strong>\uff1a\u5f8c\u7aef\u5b9a\u7fa9\u597d <code>\/v1\/todos<\/code> \u56de\u50b3 <code>{ data, pagination }<\/code> \u7684\u683c\u5f0f\uff0c\u524d\u7aef\u5c31\u7167\u9019\u500b\u683c\u5f0f\u89e3\u6790\u3002\u53ea\u8981\u5951\u7d04\u4e0d\u8b8a\uff0c\u524d\u5f8c\u7aef\u53ef\u4ee5\u5404\u81ea\u958b\u767c\u3001\u5404\u81ea\u90e8\u7f72\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u5e38\u898b\u5751\u8207\u89e3\u6cd5<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\u5751 1\uff1aGET \u8acb\u6c42\u5e36 body<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u75c7\u72c0<\/strong>\uff1a\u67d0\u4e9b HTTP \u5ba2\u6236\u7aef\u6703\u5ffd\u7565 GET \u8acb\u6c42\u7684 body\uff0c\u5c0e\u81f4\u53c3\u6578\u6c92\u9001\u5230\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u70ba\u4ec0\u9ebc\u6703\u767c\u751f<\/strong>\uff1aHTTP \u898f\u7bc4\u5141\u8a31 GET \u5e36 body\uff0c\u4f46\u4e0d\u5efa\u8b70\uff0c\u5f88\u591a\u5de5\u5177\u4e0d\u652f\u63f4\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u600e\u9ebc\u907f\u514d<\/strong>\uff1aGET \u7684\u53c3\u6578\u4e00\u5f8b\u653e\u5728 URL query string \u88e1\u3002<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-13\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-comment\"># \u6b63\u78ba<\/span>\nGET \/users?status=active&amp;page=<span class=\"hljs-number\">2<\/span>\n\n<span class=\"hljs-comment\"># \u4e0d\u8981\u9019\u6a23\u505a<\/span>\nGET \/users\nBody: {<span class=\"hljs-string\">\"status\"<\/span>: <span class=\"hljs-string\">\"active\"<\/span>, <span class=\"hljs-string\">\"page\"<\/span>: <span class=\"hljs-number\">2<\/span>}\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-13\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">\u5751 2\uff1a\u4e0d\u4e00\u81f4\u7684\u932f\u8aa4\u683c\u5f0f<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u75c7\u72c0<\/strong>\uff1a\u6709\u4e9b endpoint \u56de\u50b3 <code>{\"error\": \"...\"}<\/code> \u5b57\u4e32\uff0c\u6709\u4e9b\u56de\u50b3 <code>{\"message\": \"...\"}<\/code>\uff0c\u524d\u7aef\u4e0d\u77e5\u9053\u600e\u9ebc\u7d71\u4e00\u8655\u7406\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u70ba\u4ec0\u9ebc\u6703\u767c\u751f<\/strong>\uff1a\u6c92\u6709\u5728\u5c08\u6848\u958b\u59cb\u6642\u5b9a\u7fa9\u7d71\u4e00\u7684\u932f\u8aa4\u683c\u5f0f\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u600e\u9ebc\u907f\u514d<\/strong>\uff1a\u5728\u5c08\u6848\u4e00\u958b\u59cb\u5c31\u5b9a\u7fa9\u597d\u932f\u8aa4\u56de\u61c9\u7684\u7d50\u69cb\uff0c\u5168\u90e8 endpoint \u90fd\u9075\u5b88\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u8ddf AI \u8aaa<\/strong>\uff1a<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u300c\u5e6b\u6211\u5efa\u7acb\u4e00\u500b FastAPI \u7684\u7d71\u4e00\u932f\u8aa4\u8655\u7406\u6a5f\u5236\uff0c\u6240\u6709\u932f\u8aa4\u90fd\u56de\u50b3 <code>{error: {code, message, details}}<\/code> \u683c\u5f0f\u300d<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\">\u5751 3\uff1a\u5fd8\u8a18\u8655\u7406\u5206\u9801\u5c0e\u81f4\u6548\u80fd\u7206\u70b8<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u75c7\u72c0<\/strong>\uff1aAPI \u8d8a\u4f86\u8d8a\u6162\uff0c\u56e0\u70ba\u4e00\u6b21\u56de\u50b3\u4e86\u5e7e\u842c\u7b46\u8cc7\u6599\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u70ba\u4ec0\u9ebc\u6703\u767c\u751f<\/strong>\uff1a\u958b\u767c\u521d\u671f\u8cc7\u6599\u5c11\uff0c\u6c92\u52a0\u5206\u9801\u3002\u4e0a\u7dda\u5f8c\u8cc7\u6599\u91cf\u66b4\u589e\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u600e\u9ebc\u907f\u514d<\/strong>\uff1a\u5f9e\u7b2c\u4e00\u5929\u5c31\u52a0\u5206\u9801\uff0c\u8a2d\u5b9a <code>per_page<\/code> \u7684\u9810\u8a2d\u503c\u548c\u4e0a\u9650\u3002<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-14\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-comment\"># \u4e00\u958b\u59cb\u5c31\u9650\u5236\u597d<\/span>\nper_page: int = Query(<span class=\"hljs-keyword\">default<\/span>=<span class=\"hljs-number\">20<\/span>, le=<span class=\"hljs-number\">100<\/span>)  <span class=\"hljs-comment\"># \u6bcf\u9801\u6700\u591a 100 \u7b46<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-14\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Vibe Coder \u6aa2\u67e5\u9ede<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u770b\u5230 AI \u751f\u6210\u7684 API \u7a0b\u5f0f\u78bc\u6642\uff0c\u78ba\u8a8d\u4ee5\u4e0b\u4e8b\u9805\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>[ ] URL \u662f\u540d\u8a5e\uff08\u8cc7\u6e90\uff09\u4e0d\u662f\u52d5\u8a5e\uff08\u52d5\u4f5c\uff09\u55ce\uff1f<\/li>\n\n\n<li>[ ] HTTP \u65b9\u6cd5\u7528\u5c0d\u4e86\u55ce\uff1f\uff08GET \u8b80\u53d6\u3001POST \u5efa\u7acb\u3001PATCH \u66f4\u65b0\u3001DELETE \u522a\u9664\uff09<\/li>\n\n\n<li>[ ] \u6709\u52a0\u5206\u9801\u55ce\uff1f<code>per_page<\/code> \u6709\u8a2d\u4e0a\u9650\u55ce\uff1f<\/li>\n\n\n<li>[ ] \u932f\u8aa4\u56de\u61c9\u683c\u5f0f\u7d71\u4e00\u55ce\uff1f\u6709\u7528\u5408\u9069\u7684 HTTP \u72c0\u614b\u78bc\u55ce\uff1f<\/li>\n\n\n<li>[ ] \u6709\u7248\u672c\u865f\u55ce\uff1f\uff08<code>\/v1\/<\/code> \u524d\u7db4\uff09<\/li>\n\n\n<li>[ ] \u9700\u8981\u8a8d\u8b49\u7684 endpoint \u6709\u52a0\u4e0a\u9a57\u8b49\u55ce\uff1f<\/li>\n\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">AI \u5c0d\u8a71\u7bc4\u4f8b<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5165\u9580\u5c0d\u8a71<\/strong>\uff1a<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u300c\u5e6b\u6211\u5beb\u4e00\u500b\u5f85\u8fa6\u4e8b\u9805\u7684 API\u300d<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u9032\u968e\u5c0d\u8a71<\/strong>\uff08\u66f4\u597d\u7684\u505a\u6cd5\uff09\uff1a<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u300c\u5e6b\u6211\u7528 FastAPI \u8a2d\u8a08\u4e00\u500b\u5f85\u8fa6\u4e8b\u9805 REST API\u3002\u8981\u6c42\uff1a<br>1. RESTful \u98a8\u683c\uff0cURL \u7528 \/v1\/todos<br>2. \u652f\u63f4 CRUD\uff08GET\/POST\/PATCH\/DELETE\uff09<br>3. \u5217\u8868 API \u8981\u6709\u5206\u9801\uff08offset-based\uff0c\u6bcf\u9801\u9810\u8a2d 20 \u7b46\uff0c\u4e0a\u9650 100\uff09<br>4. \u652f\u63f4 ?completed=true \u904e\u6ffe\u548c ?sort=-created_at \u6392\u5e8f<br>5. \u7d71\u4e00\u932f\u8aa4\u683c\u5f0f {error: {code, message, details}}<br>6. \u7528 Pydantic model \u5b9a\u7fa9\u8acb\u6c42\u548c\u56de\u61c9\u7d50\u69cb\u300d<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\">\u63d0\u4f9b\u8d8a\u591a\u4e0a\u4e0b\u6587\uff0cAI \u7522\u51fa\u7684 API \u8a2d\u8a08\u5c31\u8d8a\u7b26\u5408\u6700\u4f73\u5be6\u8e10\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u5c0f\u7d50<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u8a18\u4f4f\u9019\u500b\u5224\u65b7\u6846\u67b6<\/strong>\uff1a<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li><strong>URL \u8a2d\u8a08<\/strong>\uff1a\u540d\u8a5e\uff08\u8cc7\u6e90\uff09\uff0c\u4e0d\u662f\u52d5\u8a5e\uff08\u52d5\u4f5c\uff09<\/li>\n\n\n<li><strong>HTTP \u65b9\u6cd5<\/strong>\uff1aGET \u8b80\u3001POST \u5efa\u3001PATCH \u6539\u3001DELETE \u522a<\/li>\n\n\n<li><strong>\u56de\u61c9\u683c\u5f0f<\/strong>\uff1a\u6210\u529f\u548c\u932f\u8aa4\u90fd\u8981\u6709\u4e00\u81f4\u7684\u7d50\u69cb<\/li>\n\n\n<li><strong>\u5206\u9801<\/strong>\uff1a\u5f9e\u7b2c\u4e00\u5929\u5c31\u52a0\u4e0a\uff0c\u8a2d\u597d\u4e0a\u9650<\/li>\n\n\n<li><strong>\u7248\u672c\u63a7\u5236<\/strong>\uff1a\u7528 <code>\/v1\/<\/code> \u524d\u7db4\uff0c\u52a0\u6771\u897f\u4e0d\u5347\u7248\uff0c\u6539\/\u522a\u624d\u5347\u7248<\/li>\n\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u6700\u91cd\u8981\u7684\u539f\u5247<\/strong>\uff1aAPI \u662f\u5951\u7d04\uff0c\u4e00\u65e6\u767c\u5e03\u5c31\u4e0d\u80fd\u96a8\u610f\u66f4\u52d5\u3002\u8a2d\u8a08\u6642\u591a\u82b1\u5341\u5206\u9418\u60f3\u6e05\u695a\u683c\u5f0f\uff0c\u5f8c\u9762\u5c11\u82b1\u5341\u5c0f\u6642\u4fee bug\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u5ef6\u4f38\uff1a\u77e5\u9053\u5c31\u597d<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u9019\u4e9b\u9032\u968e\u4e3b\u984c\u9047\u5230\u518d\u6df1\u5165\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>GraphQL<\/strong>\uff1a\u53e6\u4e00\u7a2e API \u98a8\u683c\uff0c\u8b93\u524d\u7aef\u81ea\u5df1\u6c7a\u5b9a\u8981\u54ea\u4e9b\u6b04\u4f4d\u3002\u9069\u5408\u8cc7\u6599\u95dc\u4fc2\u8907\u96dc\u7684\u5834\u666f<\/li>\n\n\n<li><strong>gRPC<\/strong>\uff1aGoogle \u7684\u9ad8\u6548\u80fd RPC \u6846\u67b6\uff0c\u9069\u5408\u5fae\u670d\u52d9\u4e4b\u9593\u7684\u901a\u8a0a<\/li>\n\n\n<li><strong>OpenAPI \/ Swagger<\/strong>\uff1aAPI \u6587\u4ef6\u81ea\u52d5\u751f\u6210\u5de5\u5177\uff0cFastAPI \u5167\u5efa\u652f\u63f4\uff08\u8a2a\u554f <code>\/docs<\/code> \u5c31\u80fd\u770b\u5230\uff09<\/li>\n\n\n<li><strong>Rate Limiting<\/strong>\uff1a\u9650\u5236 API \u547c\u53eb\u983b\u7387\uff0c\u9632\u6b62\u88ab\u6feb\u7528<\/li>\n\n\n<li><strong>HATEOAS<\/strong>\uff1aREST \u7684\u9032\u968e\u6982\u5ff5\uff0cAPI \u56de\u61c9\u4e2d\u5305\u542b\u76f8\u95dc\u8cc7\u6e90\u7684\u9023\u7d50<\/li>\n\n<\/ul>\n\n\n\n<div id=\"quiz-dd315cb6\">\n<style>\n#quiz-dd315cb6 .badge {\n        display: inline-block;\n        padding: 4px 10px;\n        border-radius: 12px;\n        font-size: 0.75em;\n        font-weight: bold;\n        margin-left: 8px;\n      }#quiz-dd315cb6 .badge.scenario {\n        background: #ebf8ff;\n        color: #2b6cb0;\n      }#quiz-dd315cb6 .badge.debug {\n        background: #fef3c7;\n        color: #92400e;\n      }#quiz-dd315cb6 .question-adv {\n        background: white;\n        border-radius: 10px;\n        padding: 24px;\n        margin: 20px 0;\n        box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);\n        border-left: 4px solid #ed8936;\n      }#quiz-dd315cb6 .question-adv h3 {\n        margin-top: 0;\n        color: #2d3748;\n      }#quiz-dd315cb6 .code-block {\n        background: #1e1e1e;\n        color: #d4d4d4;\n        padding: 14px;\n        border-radius: 6px;\n        font-family: \"Menlo\", \"Monaco\", \"Courier New\", monospace;\n        font-size: 0.9em;\n        overflow-x: auto;\n        margin: 12px 0;\n        white-space: pre-wrap;\n      }#quiz-dd315cb6 .options-adv {\n        list-style: none;\n        padding: 0;\n      }#quiz-dd315cb6 .options-adv li {\n        padding: 14px 16px;\n        margin: 10px 0;\n        border: 2px solid #e2e8f0;\n        border-radius: 8px;\n        cursor: pointer;\n        transition: all 0.2s;\n      }#quiz-dd315cb6 .options-adv li:hover:not(.disabled) {\n        border-color: #ed8936;\n        background: #fffaf0;\n      }#quiz-dd315cb6 .options-adv li.disabled {\n        cursor: default;\n        opacity: 0.7;\n      }#quiz-dd315cb6 .options-adv li.show-answer {\n        border-color: #48bb78;\n        background: #f0fff4;\n      }#quiz-dd315cb6 .options-adv li.wrong {\n        border-color: #fc8181;\n        background: #fff5f5;\n      }#quiz-dd315cb6 .feedback-adv {\n        margin-top: 16px;\n        padding: 14px;\n        border-radius: 8px;\n        display: none;\n        line-height: 1.6;\n      }#quiz-dd315cb6 .feedback-adv.correct {\n        background: #f0fff4;\n        color: #276749;\n        display: block;\n      }#quiz-dd315cb6 .feedback-adv.wrong {\n        background: #fff5f5;\n        color: #c53030;\n        display: block;\n      }#quiz-dd315cb6 .feedback-adv \n      .score-adv {\n        text-align: center;\n        font-size: 1.4em;\n        padding: 24px;\n        background: white;\n        border-radius: 10px;\n        margin-top: 24px;\n        box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);\n      }#quiz-dd315cb6 .intro {\n        background: #ebf8ff;\n        padding: 16px;\n        border-radius: 8px;\n        margin-bottom: 20px;\n        color: #2c5282;\n      }\n<\/style>\n<h1>\u9032\u968e\u6e2c\u9a57\uff1aAPI \u8a2d\u8a08 &#8212; \u6253\u9020\u7cfb\u7d71\u7684\u6e9d\u901a\u5951\u7d04<\/h1>\n    <div class=\"intro\">\n      <strong>\u6e2c\u9a57\u76ee\u6a19\uff1a<\/strong>\u9a57\u8b49\u4f60\u662f\u5426\u80fd\u5728\u5be6\u969b\u60c5\u5883\u4e2d\u61c9\u7528 API \u8a2d\u8a08\u539f\u5247\u3002<br \/>\n      \u5171 5 \u984c\uff0c\u5305\u542b\u60c5\u5883\u984c\u8207\u932f\u8aa4\u8a3a\u65b7\u984c\u3002\n    <\/div>\n\n    <!-- \u60c5\u5883\u984c 1 -->\n    <div class=\"question-adv\" id=\"qAdv1\">\n      <h3>1. \u4f60\u6b63\u5728\u8a2d\u8a08\u4e00\u500b\u96fb\u5546\u7cfb\u7d71\u7684 API\uff0c\u9700\u8981\u8b93\u524d\u7aef\u53d6\u5f97\u67d0\u4f4d\u4f7f\u7528\u8005\u7684\u8a02\u55ae\u5217\u8868\u3002\u4ee5\u4e0b\u54ea\u500b endpoint \u8a2d\u8a08\u6700\u7b26\u5408 RESTful \u539f\u5247\uff1f <span class=\"badge scenario\">\u60c5\u5883\u984c<\/span><\/h3>\n      <ul class=\"options-adv\">\n        <li onclick=\"checkAnswerAdv(1, 'A', 'C')\">A. <code>POST \/getOrdersByUser<\/code>\uff0c\u5728 body \u4e2d\u50b3\u9001 <code>{\"user_id\": 123}<\/code><\/li>\n        <li onclick=\"checkAnswerAdv(1, 'B', 'C')\">B. <code>GET \/orders\/getUserOrders?id=123<\/code><\/li>\n        <li onclick=\"checkAnswerAdv(1, 'C', 'C')\">C. <code>GET \/users\/123\/orders?page=1&per_page=20<\/code><\/li>\n        <li onclick=\"checkAnswerAdv(1, 'D', 'C')\">D. <code>GET \/v1\/query?type=orders&user=123<\/code><\/li>\n      <\/ul>\n      <div class=\"feedback-adv\" id=\"fbAdv1\"><\/div>\n    <\/div>\n\n    <!-- \u60c5\u5883\u984c 2 -->\n    <div class=\"question-adv\" id=\"qAdv2\">\n      <h3>2. \u4f60\u7684\u5f85\u8fa6\u4e8b\u9805 API \u5df2\u7d93\u4e0a\u7dda\uff0c\u6709\u5f88\u591a\u524d\u7aef\u5728\u4f7f\u7528\u3002\u73fe\u5728\u7522\u54c1\u7d93\u7406\u8981\u6c42\u628a\u56de\u61c9\u4e2d\u7684 <code>created_at<\/code> \u6b04\u4f4d\u6539\u540d\u70ba <code>createdAt<\/code>\uff08\u99dd\u5cf0\u547d\u540d\uff09\u3002\u4f60\u61c9\u8a72\u600e\u9ebc\u505a\uff1f <span class=\"badge scenario\">\u60c5\u5883\u984c<\/span><\/h3>\n      <ul class=\"options-adv\">\n        <li onclick=\"checkAnswerAdv(2, 'A', 'B')\">A. \u76f4\u63a5\u4fee\u6539 <code>created_at<\/code> \u70ba <code>createdAt<\/code>\uff0c\u901a\u77e5\u524d\u7aef\u66f4\u65b0<\/li>\n        <li onclick=\"checkAnswerAdv(2, 'B', 'B')\">B. \u767c\u5e03\u65b0\u7248\u672c <code>\/v2\/todos<\/code>\uff0c\u5728\u65b0\u7248\u672c\u4e2d\u4f7f\u7528 <code>createdAt<\/code>\uff0c\u820a\u7248\u672c\u4fdd\u6301\u4e0d\u8b8a<\/li>\n        <li onclick=\"checkAnswerAdv(2, 'C', 'B')\">C. \u540c\u6642\u56de\u50b3 <code>created_at<\/code> \u548c <code>createdAt<\/code> \u5169\u500b\u6b04\u4f4d\uff0c\u4e0d\u9700\u8981\u5347\u7248<\/li>\n        <li onclick=\"checkAnswerAdv(2, 'D', 'B')\">D. \u7528 Header Versioning \u5728\u540c\u4e00\u500b URL \u5340\u5206\u65b0\u820a\u683c\u5f0f<\/li>\n      <\/ul>\n      <div class=\"feedback-adv\" id=\"fbAdv2\"><\/div>\n    <\/div>\n\n    <!-- \u60c5\u5883\u984c 3 -->\n    <div class=\"question-adv\" id=\"qAdv3\">\n      <h3>3. \u4f60\u7684\u7cfb\u7d71\u9700\u8981\u540c\u6642\u652f\u63f4\u300c\u4f7f\u7528\u8005\u767b\u5165\u300d\u548c\u300c\u7b2c\u4e09\u65b9\u670d\u52d9\u547c\u53eb\u300d\u5169\u7a2e\u8a8d\u8b49\u5834\u666f\u3002\u6839\u64da\u6587\u7ae0\u5efa\u8b70\uff0c\u6700\u9069\u5408\u7684\u8a8d\u8b49\u65b9\u6848\u7d44\u5408\u662f\u4ec0\u9ebc\uff1f <span class=\"badge scenario\">\u60c5\u5883\u984c<\/span><\/h3>\n      <ul class=\"options-adv\">\n        <li onclick=\"checkAnswerAdv(3, 'A', 'D')\">A. \u5169\u7a2e\u5834\u666f\u90fd\u7528 API Key<\/li>\n        <li onclick=\"checkAnswerAdv(3, 'B', 'D')\">B. \u5169\u7a2e\u5834\u666f\u90fd\u7528 JWT Token<\/li>\n        <li onclick=\"checkAnswerAdv(3, 'C', 'D')\">C. \u4f7f\u7528\u8005\u767b\u5165\u7528 API Key\uff0c\u7b2c\u4e09\u65b9\u670d\u52d9\u7528 JWT Token<\/li>\n        <li onclick=\"checkAnswerAdv(3, 'D', 'D')\">D. \u4f7f\u7528\u8005\u767b\u5165\u7528 JWT Token\uff0c\u7b2c\u4e09\u65b9\u670d\u52d9\u7528 API Key<\/li>\n      <\/ul>\n      <div class=\"feedback-adv\" id=\"fbAdv3\"><\/div>\n    <\/div>\n\n    <!-- \u932f\u8aa4\u8a3a\u65b7\u984c 1 -->\n    <div class=\"question-adv\" id=\"qAdv4\">\n      <h3>4. \u524d\u7aef\u5de5\u7a0b\u5e2b\u56de\u5831\uff1a\u300c\u547c\u53eb API \u5217\u8868\u6642\u8d8a\u4f86\u8d8a\u6162\uff0c\u6700\u8fd1\u4e00\u6b21\u82b1\u4e86 30 \u79d2\u624d\u56de\u61c9\u3002\u300d\u4f60\u6aa2\u67e5\u4e86\u4ee5\u4e0b\u7a0b\u5f0f\u78bc\uff0c\u554f\u984c\u6700\u53ef\u80fd\u51fa\u5728\u54ea\u88e1\uff1f <span class=\"badge debug\">\u932f\u8aa4\u8a3a\u65b7<\/span><\/h3>\n      <div class=\"code-block\">@app.get(&#8220;\/v1\/products&#8221;)\ndef list_products(\n    category: str | None = None,\n    sort: str = &#8220;-created_at&#8221;\n):\n    items = list(products_db.values())\n    if category:\n        items = [p for p in items if p.category == category]\n    return {&#8220;data&#8221;: items}<\/div>\n      <ul class=\"options-adv\">\n        <li onclick=\"checkAnswerAdv(4, 'A', 'B')\">A. \u6392\u5e8f\u53c3\u6578 <code>sort<\/code> \u6c92\u6709\u88ab\u5be6\u969b\u4f7f\u7528\uff0c\u5c0e\u81f4\u56de\u50b3\u9806\u5e8f\u6df7\u4e82<\/li>\n        <li onclick=\"checkAnswerAdv(4, 'B', 'B')\">B. \u6c92\u6709\u52a0\u5206\u9801\u6a5f\u5236\uff0c\u7576\u8cc7\u6599\u91cf\u589e\u5927\u6642\u6703\u4e00\u6b21\u56de\u50b3\u6240\u6709\u8cc7\u6599<\/li>\n        <li onclick=\"checkAnswerAdv(4, 'C', 'B')\">C. \u4f7f\u7528\u4e86 <code>list()<\/code> \u8f49\u63db\uff0c\u61c9\u8a72\u76f4\u63a5\u56de\u50b3 <code>dict.values()<\/code><\/li>\n        <li onclick=\"checkAnswerAdv(4, 'D', 'B')\">D. \u904e\u6ffe\u689d\u4ef6 <code>category<\/code> \u61c9\u8a72\u653e\u5728 URL \u8def\u5f91\u800c\u975e query parameter<\/li>\n      <\/ul>\n      <div class=\"feedback-adv\" id=\"fbAdv4\"><\/div>\n    <\/div>\n\n    <!-- \u932f\u8aa4\u8a3a\u65b7\u984c 2 -->\n    <div class=\"question-adv\" id=\"qAdv5\">\n      <h3>5. \u524d\u7aef\u547c\u53eb\u4ee5\u4e0b API \u66f4\u65b0\u5f85\u8fa6\u4e8b\u9805\u7684\u6a19\u984c\uff0c\u4f46\u767c\u73fe <code>description<\/code> \u548c <code>completed<\/code> \u6b04\u4f4d\u88ab\u6e05\u7a7a\u4e86\u3002\u9019\u6bb5\u7a0b\u5f0f\u78bc\u54ea\u88e1\u51fa\u4e86\u554f\u984c\uff1f <span class=\"badge debug\">\u932f\u8aa4\u8a3a\u65b7<\/span><\/h3>\n      <div class=\"code-block\"># \u524d\u7aef\u8acb\u6c42\n# PATCH \/v1\/todos\/42\n# Body: {&#8220;title&#8221;: &#8220;\u65b0\u6a19\u984c&#8221;}\n\n# \u5f8c\u7aef\u8655\u7406\n@app.patch(&#8220;\/v1\/todos\/{todo_id}&#8221;)\ndef update_todo(todo_id: int, updates: TodoUpdate):\n    existing = todos_db[todo_id]\n    update_data = updates.model_dump()  # \u53d6\u51fa\u6240\u6709\u6b04\u4f4d\n    updated = existing.model_copy(update=update_data)\n    todos_db[todo_id] = updated\n    return updated<\/div>\n      <ul class=\"options-adv\">\n        <li onclick=\"checkAnswerAdv(5, 'A', 'C')\">A. \u61c9\u8a72\u7528 PUT \u800c\u4e0d\u662f PATCH\uff0c\u56e0\u70ba PATCH \u4e0d\u652f\u63f4\u90e8\u5206\u66f4\u65b0<\/li>\n        <li onclick=\"checkAnswerAdv(5, 'B', 'C')\">B. <code>model_copy()<\/code> \u65b9\u6cd5\u4e0d\u652f\u63f4\u7528 <code>update<\/code> \u53c3\u6578\u8986\u84cb\u6b04\u4f4d<\/li>\n        <li onclick=\"checkAnswerAdv(5, 'C', 'C')\">C. <code>model_dump()<\/code> \u61c9\u8a72\u52a0\u4e0a <code>exclude_unset=True<\/code>\uff0c\u5426\u5247\u6c92\u50b3\u7684\u6b04\u4f4d\u6703\u8b8a\u6210 <code>None<\/code> \u8986\u84cb\u539f\u503c<\/li>\n        <li onclick=\"checkAnswerAdv(5, 'D', 'C')\">D. \u524d\u7aef\u61c9\u8a72\u50b3\u9001\u5b8c\u6574\u7684\u7269\u4ef6\uff08\u5305\u542b\u6240\u6709\u6b04\u4f4d\uff09\uff0c\u4e0d\u80fd\u53ea\u50b3 <code>title<\/code><\/li>\n      <\/ul>\n      <div class=\"feedback-adv\" id=\"fbAdv5\"><\/div>\n    <\/div>\n\n    <div class=\"score-adv\" id=\"scoreAdv\" style=\"display:none;\"><\/div>\n<script>\n\n      let answeredAdv = 0;\n      let correctAdv = 0;\n      const totalAdv = 5;\n      const explanationsAdv = {\n        1: \" \u9078\u9805 C \u6700\u7b26\u5408 RESTful \u539f\u5247\uff1aURL \u7528\u540d\u8a5e\u8868\u793a\u8cc7\u6e90\uff08<code>\/users\/123\/orders<\/code> \u8868\u793a\u300c123 \u865f\u4f7f\u7528\u8005\u7684\u8a02\u55ae\u300d\uff09\uff0c\u7528 GET \u65b9\u6cd5\u8b80\u53d6\uff0c\u4e26\u4e14\u5e36\u6709\u5206\u9801\u53c3\u6578\u3002\u9078\u9805 A \u7528\u4e86\u52d5\u8a5e <code>getOrdersByUser<\/code> \u4e14\u7528 POST \u505a\u8b80\u53d6\uff1b\u9078\u9805 B \u7684 URL \u6df7\u5408\u4e86\u52d5\u8a5e\uff1b\u9078\u9805 D \u7528\u4e86\u901a\u7528\u7684 query endpoint\uff0c\u4e0d\u662f\u8cc7\u6e90\u5c0e\u5411\u3002\",\n        2: \" \u91cd\u65b0\u547d\u540d\u6b04\u4f4d\u662f\u300c\u7834\u58de\u6027\u4fee\u6539\u300d\uff0c\u6703\u8b93\u4f9d\u8cf4 <code>created_at<\/code> \u7684\u524d\u7aef\u7a0b\u5f0f\u78bc\u58de\u6389\u3002\u6839\u64da\u6587\u7ae0\u7684\u7248\u672c\u63a7\u5236\u539f\u5247\uff0c\u300c\u6539\u6771\u897f\u300d\u9700\u8981\u5347\u7248\u3002\u9078\u9805 A \u76f4\u63a5\u6539\u6703\u7834\u58de\u73fe\u6709\u7528\u6236\u7aef\uff1b\u9078\u9805 C \u96d6\u7136\u904e\u6e21\u671f\u53ef\u884c\uff0c\u4f46\u9577\u671f\u6703\u9020\u6210\u6df7\u4e82\u4e14\u4e0d\u662f\u6a19\u6e96\u505a\u6cd5\uff1b\u9078\u9805 D \u6280\u8853\u4e0a\u53ef\u884c\u4f46\u6587\u7ae0\u5efa\u8b70\u7528 URL \u8def\u5f91\u7248\u672c\u66f4\u7c21\u55ae\u76f4\u89ba\u3002\",\n        3: \" \u6587\u7ae0\u660e\u78ba\u6307\u51fa\uff1aJWT Token \u9069\u5408\u300c\u4f7f\u7528\u8005\u767b\u5165\u3001\u524d\u5f8c\u7aef\u5206\u96e2\u300d\uff0c\u56e0\u70ba Token \u88e1\u5e36\u6709\u4f7f\u7528\u8005\u8cc7\u8a0a\u4e14\u6703\u904e\u671f\u3002API Key \u9069\u5408\u300c\u5f8c\u7aef\u670d\u52d9\u4e4b\u9593\u3001\u7b2c\u4e09\u65b9 API\u300d\uff0c\u56e0\u70ba\u7c21\u55ae\u4e14\u4e0d\u904e\u671f\uff08\u9664\u975e\u4e3b\u52d5\u64a4\u92b7\uff09\u3002\u6240\u4ee5\u6700\u4f73\u7d44\u5408\u662f\u4f7f\u7528\u8005\u767b\u5165\u7528 JWT\uff0c\u7b2c\u4e09\u65b9\u670d\u52d9\u7528 API Key\u3002\",\n        4: \" \u9019\u6bb5\u7a0b\u5f0f\u78bc\u6c92\u6709\u5206\u9801\u6a5f\u5236\uff08\u6c92\u6709 <code>page<\/code> \u548c <code>per_page<\/code> \u53c3\u6578\uff09\uff0c\u7576 <code>products_db<\/code> \u7684\u8cc7\u6599\u91cf\u5f9e\u958b\u767c\u6642\u7684\u5e7e\u5341\u7b46\u589e\u9577\u5230\u4e0a\u7dda\u5f8c\u7684\u5e7e\u842c\u7b46\uff0cAPI \u6703\u4e00\u6b21\u56de\u50b3\u6240\u6709\u8cc7\u6599\uff0c\u5c0e\u81f4\u56de\u61c9\u6642\u9593\u66b4\u589e\u3002\u6587\u7ae0\u5f37\u8abf\u300c\u5f9e\u7b2c\u4e00\u5929\u5c31\u52a0\u5206\u9801\uff0c\u8a2d\u5b9a <code>per_page<\/code> \u7684\u9810\u8a2d\u503c\u548c\u4e0a\u9650\u300d\u3002\u6392\u5e8f\u53c3\u6578\u96d6\u7136\u6c92\u88ab\u4f7f\u7528\uff0c\u4f46\u4e0d\u662f\u6548\u80fd\u554f\u984c\u7684\u6839\u672c\u539f\u56e0\u3002\",\n        5: \" \u95dc\u9375\u5728\u65bc <code>model_dump()<\/code> \u548c <code>model_dump(exclude_unset=True)<\/code> \u7684\u5dee\u7570\u3002\u4e0d\u52a0 <code>exclude_unset=True<\/code> \u6642\uff0c\u6240\u6709\u6b04\u4f4d\u90fd\u6703\u88ab\u53d6\u51fa\uff08\u6c92\u50b3\u7684\u6b04\u4f4d\u503c\u70ba <code>None<\/code>\uff09\uff0c\u7136\u5f8c <code>None<\/code> \u6703\u8986\u84cb\u6389\u539f\u672c\u7684\u503c\u3002\u52a0\u4e0a <code>exclude_unset=True<\/code> \u5f8c\uff0c\u53ea\u6703\u53d6\u51fa\u300c\u6709\u5be6\u969b\u50b3\u9001\u7684\u6b04\u4f4d\u300d\uff0c\u5176\u4ed6\u6b04\u4f4d\u4fdd\u6301\u4e0d\u8b8a\u3002\u9019\u6b63\u662f PATCH\uff08\u90e8\u5206\u66f4\u65b0\uff09\u7684\u6b63\u78ba\u5be6\u4f5c\u65b9\u5f0f\u3002\"\n      };\n\n      function checkAnswerAdv(qNum, selected, correctAns) {\n        const question = document.getElementById(\"qAdv\" + qNum);\n        if (question.classList.contains(\"answered\")) return;\n\n        question.classList.add(\"answered\");\n        answeredAdv++;\n\n        const options = question.querySelectorAll(\".options-adv li\");\n        options.forEach((opt) => {\n          opt.classList.add(\"disabled\");\n          if (opt.textContent.startsWith(correctAns + \".\")) {\n            opt.classList.add(\"show-answer\");\n          }\n        });\n\n        const feedback = document.getElementById(\"fbAdv\" + qNum);\n        if (selected === correctAns) {\n          correctAdv++;\n          feedback.className = \"feedback-adv correct\";\n          feedback.innerHTML = \"\u2713 \u6b63\u78ba\uff01\" + explanationsAdv[qNum];\n        } else {\n          feedback.className = \"feedback-adv wrong\";\n          feedback.innerHTML =\n            \"\u2717 \u932f\u8aa4\u3002\u6b63\u78ba\u7b54\u6848\u662f \" + correctAns + \"\u3002\" + explanationsAdv[qNum];\n          options.forEach((opt) => {\n            if (opt.textContent.startsWith(selected + \".\")) {\n              opt.classList.add(\"wrong\");\n            }\n          });\n        }\n\n        if (answeredAdv === totalAdv) {\n          const scoreDiv = document.getElementById(\"scoreAdv\");\n          scoreDiv.style.display = \"block\";\n          let msg = \"\";\n          if (correctAdv === totalAdv) msg = \"\ud83c\udfaf \u5b8c\u7f8e\uff01\u4f60\u5df2\u7d93\u6e96\u5099\u597d\u5be6\u6230\u4e86\uff01\";\n          else if (correctAdv >= Math.ceil(totalAdv * 0.8))\n            msg = \"\ud83d\udcaa \u5f88\u68d2\uff01\u518d\u8907\u7fd2\u4e00\u4e0b\u932f\u7684\u984c\u76ee\";\n          else if (correctAdv >= Math.ceil(totalAdv * 0.6))\n            msg = \"\ud83d\udcd6 \u5efa\u8b70\u91cd\u8b80\u76f8\u95dc\u6bb5\u843d\u5f8c\u518d\u8a66\u4e00\u6b21\";\n          else msg = \"\ud83d\udd04 \u5efa\u8b70\u91cd\u65b0\u95b1\u8b80\u6587\u4ef6\uff0c\u7279\u5225\u6ce8\u610f\u64cd\u4f5c\u6d41\u7a0b\";\n          scoreDiv.innerHTML =\n            \"\u6e2c\u9a57\u5b8c\u6210\uff01\u5f97\u5206\uff1a\" + correctAdv + \" \/ \" + totalAdv + \"<br>\" + msg;\n        }\n      }\n    \n<\/script>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>\u6e2c\u9a57\uff1aAPI \u8a2d\u8a08 &#8212; \u6253\u9020\u7cfb\u7d71\u7684\u6e9d\u901a\u5951\u7d04 \u5171 5 \u984c\uff0c\u9ede\u9078\u7b54\u6848\u5f8c\u6703\u7acb\u5373\u986f\u793a\u7d50\u679c 1. \u5728 RES [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rolpb_likes":0,"footnotes":""},"categories":[753],"tags":[755,291,754,240,269,300,756],"class_list":["post-774","post","type-post","status-publish","format-standard","hentry","category-api","tag-api","tag-fastapi","tag-http","tag-python","tag-react","tag-restful-api","tag-756"],"blocksy_meta":{"styles_descriptor":{"styles":{"desktop":"","tablet":"","mobile":""},"google_fonts":[],"version":7}},"_links":{"self":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/posts\/774","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/comments?post=774"}],"version-history":[{"count":0,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/posts\/774\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/media?parent=774"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/categories?post=774"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/tags?post=774"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}