API�鍙戜腑的刄RL缂栫爜锛綘涓嶇煡撶殑鍧戜笌瑙ｅ喅鏂 | 胖袋鼠锟?/title> <meta name="description" content="璇︾粏浠粛URL缂栫爜鍦ˋPI�鍙戜腑的勫簲鐢ㄣ�佹煡璇㈠鏁板鐞嗐�佽矾寰勫鏁扮併�丷ESTful API缂栫爜瑙寖锛屼互鍙婂父瑙棶棰樿В鍐柟堬?> <meta name="keywords" content="URL缂栫,API�锟?RESTful API,鏌ヨ鍙傛暟,璺緞鍙傛暟,缂栫爜瑙,Web�锟?API璁捐"> <link rel="canonical" href="https://zhihuinews.com/articles/api-url-encoding-guide.html">  <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "API�鍙戜腑的刄RL缂栫爜锛綘涓嶇煡撶殑鍧戜笌瑙ｅ喅鏂", "description": "璇︾粏浠粛URL缂栫爜鍦ˋPI�鍙戜腑的勫簲鐢ㄣ�佹煡璇㈠鏁板鐞嗐�佽矾寰勫鏁扮併�丷ESTful API缂栫爜瑙寖锛屼互鍙婂父瑙棶棰樿В鍐柟堬?, "datePublished": "2026-04-26", "dateModified": "2026-04-26", "url": "https://zhihuinews.com/articles/api-url-encoding-guide.html", "author": { "@type": "Organization", "name": "胖袋鼠锟? }, "publisher": { "@type": "Organization", "name": "胖袋鼠锟? } } </script>  <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "棣栭", "item": "https://zhihuinews.com/index.html" }, { "@type": "ListItem", "position": 2, "name": "鏂囨", "item": "https://zhihuinews.com/articles/index.html" }, { "@type": "ListItem", "position": 3, "name": "API�鍙戜腑的刄RL缂栫爜锛綘涓嶇煡撶殑鍧戜笌瑙ｅ喅鏂", "item": "https://zhihuinews.com/articles/api-url-encoding-guide.html" } ] } </script> <style> * { margin: 0; padding: 0; box-sizing: border-box; } :root { --bg-color: #ffffff; --text-color: #1f2937; --link-color: #2563eb; --border-color: #e5e7eb; --code-bg: #f6f8fa; --quote-bg: #fafbfc; --quote-border: #e2e8f0; --card-bg: #f9fafb; } @media (prefers-color-scheme: dark) { :root { --bg-color: #111827; --text-color: #f3f4f6; --link-color: #60a5fa; --border-color: #374151; --code-bg: #1e1e1e; --quote-bg: #2d2d2d; --quote-border: #4b5563; --card-bg: #1f2937; } } body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; background-color: var(--bg-color); color: var(--text-color); line-height: 1.4; min-height: 100vh; } .container { max-width: 1000px; margin: 0 auto; padding: 0 20px; } @media (max-width: 768px) { .container { padding: 0 15px; } } .back-link { display: inline-block; margin: 20px 0; color: var(--link-color); text-decoration: none; font-size: 14px; } .back-link:hover { text-decoration: underline; } .article { background-color: var(--bg-color); border-radius: 8px; padding: 40px; box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1); } @media (max-width: 768px) { .article { padding: 24px; } } h1 { font-size: 32px; line-height: 1.3; font-weight: 600; margin-bottom: 16px; } @media (max-width: 768px) { h1 { font-size: 28px; } } h2 { font-size: 24px; line-height: 1.3; font-weight: 600; margin-top: 48px; margin-bottom: 12px; } @media (max-width: 768px) { h2 { font-size: 22px; } } h3 { font-size: 20px; line-height: 1.4; font-weight: 600; margin-top: 32px; margin-bottom: 8px; } @media (max-width: 768px) { h3 { font-size: 18px; } } h4 { font-size: 18px; line-height: 1.4; font-weight: 500; margin-top: 24px; margin-bottom: 8px; } @media (max-width: 768px) { h4 { font-size: 16px; } } p { margin-bottom: 14px; font-size: 16px; } @media (max-width: 768px) { p { font-size: 15px; } } a { color: var(--link-color); text-decoration: none; } a:hover { text-decoration: underline; } ul, ol { padding-left: 24px; margin-bottom: 20px; } li { margin-bottom: 8px; font-size: 16px; } @media (max-width: 768px) { li { font-size: 15px; } } .code-block { background-color: var(--code-bg); font-family: 'Courier New', Consolas, monospace; font-size: 14px; padding: 16px; border-radius: 8px; overflow-x: auto; margin: 16px 0; } blockquote { border-left: 4px solid var(--quote-border); background-color: var(--quote-bg); padding: 12px 16px; font-style: italic; font-size: 15px; margin: 16px 0; } img { display: block; max-width: 100%; margin: 20px auto; border-radius: 8px; } figcaption { text-align: center; font-size: 14px; color: #6c757d; margin-top: 8px; margin-bottom: 20px; } .metadata { display: flex; gap: 16px; font-size: 14px; color: #6c757d; margin-bottom: 32px; flex-wrap: wrap; } .metadata span { display: flex; align-items: center; gap: 4px; } .related-tools { margin-top: 64px; margin-bottom: 48px; } .related-tools h3 { font-size: 20px; font-weight: 600; margin-bottom: 24px; } .tool-grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 16px; margin-bottom: 24px; } @media (max-width: 768px) { .tool-grid { grid-template-columns: repeat(2, 1fr); } } .tool-card { background-color: var(--card-bg); border-radius: 8px; padding: 12px; border: 1px solid var(--border-color); } .tool-card h4 { margin-top: 0; margin-bottom: 4px; font-size: 16px; line-height: 1.2; } .tool-card p { margin-bottom: 8px; font-size: 14px; line-height: 1.3; color: #6c757d; } .tool-card a { font-size: 14px; } .more-tools { margin-top: 16px; font-size: 14px; } .related-docs { margin-top: 48px; margin-bottom: 48px; } .related-docs h3 { font-size: 20px; font-weight: 600; margin-bottom: 24px; } .doc-list { list-style: none; padding: 0; } .doc-list li { margin-bottom: 16px; background-color: var(--card-bg); border-radius: 8px; padding: 12px; border: 1px solid var(--border-color); } .doc-list h4 { margin-top: 0; margin-bottom: 4px; font-size: 16px; } .doc-list p { margin-bottom: 0; font-size: 14px; color: #6c757d; } .all-docs { margin-top: 24px; font-size: 14px; background-color: var(--card-bg); border-radius: 8px; padding: 12px; border: 1px solid var(--border-color); display: flex; align-items: center; min-height: 60px; } .footer { margin-top: 64px; padding-top: 24px; border-top: 1px solid var(--border-color); } </style> <script src="../assets/baidu-analytics.js"></script> </head> <body> <div class="container"> <div class="header-bar"> <a href="../index.html" class="back-link">← 返回首页</a> <a href="../index.html" class="tool-brand-link"><span class="brand-icon"></span>胖鼠<span class="brand-domain" style="font-weight:700;font-size:0.9rem;color:#333;opacity:0.8;margin-left:0.12rem;letter-spacing:0.8px;font-family:'Helvetica Neue','Arial Narrow',Arial,sans-serif;font-stretch:condensed;">pangdaishu.com</span></a> </div><div class="article"> <h1>API�鍙戜腑的刄RL缂栫爜锛綘涓嶇煡撶殑鍧戜笌瑙ｅ喅鏂</h1> <div class="metadata"> <span>胖袋鼠锟?/span> <span>2026-04-26</span> </div> <p>鍦ˋPI�鍙戜腑锛RL缂栫爜鏄涓湅浼肩畝鍗曞嵈鍏呮弧闄烽槺的勯鍩熴�傚緢澶紑鍙戣�杩欎釜鐪嬩技鍩虹的棶棰樹笂缈昏溅锛屽鑷PI鍑虹幇涔辩爜銆佽В鏋愰敊璇�佸畨鍏ㄦ紡娲炵瓑闂銆備綘鏄惁涔熼亣鍒拌繃杩欎簺闂锛腑鏂囧弬鏁板彉鎴贡鐮併�佺娈婂瓧绗﹀鑷磋В鏋け璐ャ�佸璇█鏀寔鍑虹幇鎴柇锟�?/p> <p>鏈枃灏嗘繁鍏ユ帰璁ˋPI�鍙戜腑URL缂栫爜的悇锟?锟�?锛屽苟鎻緵缁忚繃瀹炴楠岃瘉的В鍐虫柟堛�傛棤璁轰綘鏄墠绔紑鍙戣�呫�佸悗绔伐绋锛岃繕鏄叏鏍堝伐绋锛岄兘鑳戒粠鏈枃涓幏寰疄鐢ㄧ殑缁忛獙锟?/p> <h2>涓�銆丄PI�鍙戜腑URL缂栫爜的壒娈婏拷?/h2> <h3>1. URL缂栫爜鍦ˋPI涓殑閲嶈锟�?/h3> <p>API锛圓pplication Programming Interface锛槸鐜唬杞欢�鍙戜腑杩炴帴涓嶅悓荤粺的勬ˉ姊併�俇RL浣滀负API的勪富瑕佽闂柟忥紝鍏剁佸鐞嗙洿鎺ュ鍝嶅埌API的勫彲鐢ㄦ�с�佸吋�у拰叏э?/p> <p>API涓殑URL缂栫爜闇�瑕佽�檻的洜绱犳瘮鏅�歐eb椤甸潰鏇村澶嶆潅锟�?/p> <ul> <li><strong>璺ㄥ钩鍙板吋瀹�э</strong>API鍙兘琚悇绉嶅鎴风璋冪敤锛岄渶瑕佸鐞嗕笉鍚岀殑缂▼璇█鍜屽钩锟?/li> <li><strong>鏁版嵁屾暣鎬э</strong>繚浼犺的勬暟鎹湪鎺ユ敹绔兘澶熸纭В锟?/li> <li><strong>瀹叏э</strong>闃叉缂爜鐩稿叧的勫畨鍏ㄦ紡锟�?/li> <li><strong>ц兘锟?/strong>厤涓嶅繀瑕佺殑缂爜艰URL杩囬</li> </ul> <h3>2. API URL的勭粨锟?/h3> <p>涓�涓鍨殑RESTful API URL缁撴濡備笅锟?/p> <div class="code-block"> https://api.example.com/v1/users/123/profile?token=abc123&fields=name,email,phone </div> <p>URL的勫悇涓儴鍒嗛兘鍙兘闇�瑕佺佸鐞嗭</p> <ul> <li><strong>鍗忚鍜屽煙鍚嶏</strong>父涓嶉渶瑕佺锟�?/li> <li><strong>API鐗堟湰锟?/strong>父浣跨敤瀛瘝鏁板瓧锛屼笉闇�瑕佺锟�?/li> <li><strong>璺緞鍙傛暟锟�?/strong>锟�? users/123涓123</li> <li><strong>璧勬鏍囪瘑绗︼細</strong>濡備腑鏂囩敤鎴峰悕銆佺娈奍D锟�?/li> <li><strong>鏌ヨ鍙傛暟锟�?/strong>閿�煎褰㈠紡浼犻�掔殑鏁版</li> <li><strong>Fragment锟�?/strong>ㄤ簬瀹㈡埛绔鑸紝閫父涓嶅湪鏈嶅姟鍣ㄧ澶勭</li> </ul> <h3>3. URL缂栫爜的锟�?/h3> <p>鍦ˋPI�鍙戜腑锛RL缂栫爜闈复的富瑕佹鎴樺寘鎷細</p> <ol> <li><strong>瀛闆嗕笉涓�鑷达細</strong>涓嶅悓绯荤粺浣跨敤涓嶅悓的勯璁ゅ瓧绗﹂泦</li> <li><strong>缂栫爜标准噯宸紓锟?/strong>涓嶅悓璇█鍜屾鏋剁殑缂栫爜炵幇鍙兘鏈樊锟�?/li> <li><strong>宓屽缂爜锟?/strong>鏁版嵁鍙兘缁忚繃澶眰缂</li> <li><strong>鐗畩鍦烘櫙锟?/strong>濡傛枃浠朵笂浼犮�佸璇█寔銆佷簩杩涘埗鏁版嵁锟?/li> </ol> <h2>浜屻�佹煡璇㈠弬鏁扮殑缂爜澶</h2> <h3>1. 鏌ヨ鍙傛暟缂栫爜鍩虹</h3> <p>鏌ヨ鍙傛暟鏄疉PI涓渶甯哥敤的勬暟鎹紶掓柟忥紝鍏剁渶瑕佺鍒敞鎰忥</p> <div class="code-block"> # 鏌ヨ鍙傛暟的刄RL缁撴 ?key1=value1&key2=value2&key3=value3 </div> <p>姣忎釜鏌鍙傛暟鐢遍鍊煎缁勬垚锛岄敭鍜屽�奸兘闇�瑕佺紪侊細</p> <div class="code-block"> # 鍘熷URL https://api.example.com/search?q=Python鏁欑&page=1 # 缂栫爜鍚庣殑URL https://api.example.com/search?q=Python%E6%95%99%E7%A8%8B&page=1 </div> <h3>2. 鏌ヨ鍙傛暟缂栫爜的父瑙敊锟?/h3> <h4>閿欒涓�锛彧缂爜鍊间笉缂栫爜锟?/h4> <p>寰堝�鍙戣�彧鍏敞鍙傛暟鍊肩殑缂爜锛屽拷鐣ヤ簡鍙傛暟閿殑缂爜锟?/p> <div class="code-block"> # 閿欒绀轰緥锛氬鏁伴鍖呭惈鐗规畩瀛浣嗘缂栫 https://api.example.com/search?q=test&user name=john # 姝ｇ‘鍋硶锛鏁伴涔熼渶瑕佺紪锟�? https://api.example.com/search?q=test&user%20name=john </div> <h4>閿欒浜岋細閲嶅缂</h4> <p>瀵瑰凡缁忕紪佺殑瀛涓插娆＄侊細</p> <div class="code-block"> # 鍘熷锟? q=浣犲 # 绗竴娆＄紪锟�? q=%E4%BD%A0%E5%A5%BD # 閿欒锛娆＄锟�? q=%25E4%25BD%25A0%25E5%25A5%25BD # %琚佹垚%25 # 姝ｇ‘锛彧缂爜涓�锟? q=%E4%BD%A0%E5%A5%BD </div> <h4>閿欒涓夛細缂栫爜闆嗕笉涓�锟?/h4> <p>鍓嶇浣跨UTF-8缂栫爜锛屽悗绔娇鐢℅BK瑙ｇ爜锟?/p> <div class="code-block"> # 鍓嶇锛圝avaScript锛岄璁TF-8锟�? encodeURIComponent('浣犲') // "%E4%BD%A0%E5%A5%BD" # 鍚庣锛圥ython锛屼娇鐢℅BK瑙ｇ爜锟? urllib.parse.unquote('%E4%BD%A0%E5%A5%BD', encoding='gbk') // 涔辩爜锟? </div> <h3>3. 鏌ヨ鍙傛暟缂栫爜的渶浣冲疄锟�?/h3> <h4>浣跨敤标准噯锟�?/h4> <p>粓浣跨敤璇█鎻緵的爣鍑RL缂栫爜搴擄紝涓嶈鑷繁鎵姩澶悊锟?/p> <div class="code-block"> # JavaScript const params = new URLSearchParams(); params.append('q', 'Python鏁欑'); params.append('page', '1'); const url = `https://api.example.com/search?${params.toString()}`; // 鑷姩澶悊缂 # Python from urllib.parse import urlencode, quote params = {'q': 'Python鏁欑', 'page': 1} query_string = urlencode(params) # 鑷姩澶悊缂 url = f"https://api.example.com/search?{query_string}" </div> <h4>缁熶竴锟�?/h4> <p>繚鍓嶅悗绔娇ㄧ浉鍚岀殑闆嗭紙鎺ㄨ崘UTF-8锛細</p> <div class="code-block"> # Python Flask 璁剧 app.config['JSON_AS_ASCII'] = False app.config['RESTful_API_ENCODING'] = 'utf-8' # Java Spring Boot 璁剧 server.tomcat.uri-encoding=UTF-8 </div> <h2>涓�佽矾寰勫鏁扮殑缂爜澶</h2> <h3>1. RESTful API涓殑璺緞鍙傛</h3> <p>鍦≧ESTful API涓紝璺緞鍙傛暟鐢ㄤ簬鏍囪瘑鐗瑰畾璧勬锟�?/p> <div class="code-block"> # 鑾峰彇鐗瑰畾ㄦ埛 GET /users/123 # 鑾峰彇鐗瑰畾鏂囩 GET /articles/python-tutorial # 鑾峰彇鐗瑰畾鏂囦 GET /files/骞村害鎶ュ憡-2026.pdf </div> <h3>2. 璺緞鍙傛暟缂栫爜的锟�?/h3> <h4>鏂滄闂</h4> <p>URL涓殑鏂滄潬锟�?锛槸璺緞鍒嗛绗︼紝涓嶈兘鍑虹幇鍦ㄨ矾勫鏁腑锟�?/p> <div class="code-block"> # 閿欒锛枃浠跺悕鍖呭惈鏂滄潬 GET /files/2026/骞村害鎶ュ憡.pdf # 鏈嶅姟鍣ㄤ細璁や负璺緞锟�?/files/2026/ # 姝ｇ‘锛氱紪佹枩锟�? GET /files/2026%2F%E5%B9%B4%E5%BA%A6%E6%8A%A5%E5%91%8A.pdf </div> <h4>涓枃闂</h4> <p>涓枃璺緞鍙傛暟闇�瑕佺鍒敞鎰忕侊細</p> <div class="code-block"> # 鍘熷璺緞 GET /articles/Python鏁欑 # 缂栫爜锟? GET /articles/Python%E6%95%99%E7%A8%8B </div> <h3>3. 璺緞鍙傛暟缂栫爜的渶浣冲疄锟�?/h3> <h4>浣跨URL瀹叏的勬爣璇嗙</h4> <p>灏介噺浣跨敤鏁板ID鎴栧瓧姣嶆暟瀛爣璇嗙锛岄伩鍏嶇洿鎺ヤ娇ㄤ腑鏂囨垨鐗规畩瀛锟�?/p> <div class="code-block"> # 鎺ㄨ崘鍋硶锛娇鐢↖D GET /users/123 # 涓嶆帹鑽愶細鐩存帴浣跨敤涓 GET /users/犱笁 # 鍙兘艰嚧鍚闂 # 鎶樹腑鏂规锛氫娇鐢ㄧ紪佸悗的処D GET /users/%E5%BC%A0%E4%B8%89 # 闇�瑕佹纭锟�? </div> <h4>璺緞鍙傛暟鍗曠缂栫</h4> <p>瀵矾寰勫鏁拌繘琛屽崟鐙侊細</p> <div class="code-block"> # JavaScript const username = '犱笁'; const encodedUsername = encodeURIComponent(username); const url = `https://api.example.com/users/${encodedUsername}`; # Python from urllib.parse import quote username = '犱笁' encoded_username = quote(username, safe='') url = f"https://api.example.com/users/{encoded_username}" </div> <h2>鍥涖�丷ESTful API缂栫爜瑙</h2> <h3>1. RFC 3986标准</h3> <p>RESTful API的刄RL缂栫爜搴旇靛惊RFC 3986标准锟�?/p> <div class="code-block"> # RFC 3986 淇濈瀛 unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~" # 闈炰繚鐣欏瓧绗︿笉闇�瑕佺紪锟�? # 鍏朵瀛蹇呴』缂 </div> <h3>2. API鐗堟湰鎺у埗涓殑缂栫</h3> <p>API鐗堟湰鍙烽�父涓嶉渶瑕佺侊紝浣嗚娉ㄦ剰鏍煎紡锟?/p> <div class="code-block"> # 鎺ㄨ崘的増鏈牸锟�? GET /v1/users # 浣跨敤灏忓啓瀛瘝 GET /v2/articles # 鐗堟湰涔棿淇濇寔涓�锟�? # 涓嶆帹鑽殑鏍煎紡 GET /V1/users # 澶у啓V GET /v1.0/users # 鏁扮 </div> <h3>3. 鍒嗛〉鍙傛暟的勭锟�?/h3> <p>鍒嗛〉鏄疉PI的勫父瑙渶姹傦紝缂栫爜鏃堕渶瑕佹敞鎰忥細</p> <div class="code-block"> # 标准鍒嗛〉鍙傛暟 GET /articles?page=1&per_page=20 # ︽帓搴忕殑鍒嗛 GET /articles?page=1&per_page=20&sort=created_at&order=desc # 鐗畩鍊肩殑缂 GET /articles?tags=%E5%BF%83%E7%90%86,%E7%A4%BE%E4%BC%9A # 澶氫釜鏍囩ㄩ�彿鍒嗛 </div> <h3>4. 杩囨护鍜屾悳绱㈠鏁扮殑缂</h3> <p>澶嶆潅的繃ゅ拰鎼滅储鏉闇�瑕佷粩缁嗙侊細</p> <div class="code-block"> # 杩囨护鏉′ GET /products?category=鐢靛瓙浜у&brand=鑻灉&price_min=1000&price_max=5000 # 鎼滅储鏉′ GET /articles?q=Python%E7%BC%96%E7%A8%8B&fields=title,content,author # 鏃ユ湡鑼冨洿 GET /events?start_date=2026-01-01&end_date=2026-12-31 </div> <h2>浜斻�佸父瑙棶棰樹笌瑙ｅ喅鏂规</h2> <h3>1. 涓枃涔辩爜闂</h3> <p>涓枃涔辩爜鏄疉PI�鍙戜腑鏈�歌的勯棶棰樹涓�锟?/p> <h4>闂鍘熷洜</h4> <ul> <li>鍓嶅悗绔瓧绗﹂泦涓嶄锟?/li> <li>澶氭缂爜鎴敊璇紪锟�?/li> <li>鐗畩瀛澶勭悊涓嶅綋</li> </ul> <h4>瑙ｅ喅鏂规</h4> <div class="code-block"> # 缁熶竴浣跨敤UTF-8缂栫 # Node.js Express app.use((req, res, next) => { req.setEncoding('utf8'); next(); }); # Python Flask from flask import Flask, request app = Flask(__name__) app.config['JSON_AS_ASCII'] = False # Java Spring Boot @RestController public class ApiController { @RequestMapping(value = "/api/**", produces = "application/json; charset=UTF-8") public String api() { return "UTF-8鍝嶅"; } } </div> <h3>2. 鐗畩瀛瀵艰嚧瑙ｆ澶</h3> <p>鏌愪簺鐗规畩瀛鍦║RL涓湁鐗规畩鍚箟锛岄渶瑕佺壒鍒敞鎰忥</p> <h4>闇�瑕佺佺殑鐗畩瀛</h4> <div class="code-block"> # & 绗﹀ - 鍙傛暟鍒嗛锟? # 濡傛灉鍊间腑鍖呭&锛屽椤荤锟�? ?search=Tom%26Jerry # = 绗﹀ - 閿�煎鍒嗛殧锟? # 濡傛灉鍊间腑鍖呭=锛屽椤荤锟�? ?value=a%3Db # + 绗﹀ - 绌烘牸的紶缁熻锟? # 濡傛灉鍊间腑鍖呭+锛岀佸悗锟�?2B ?code=a%2Bb # # 绗﹀ - Fragment鍒嗛殧锟? # 缂栫爜鍚庢槸%23 ?hash=abc%23def </div> <h3>3. URL害闄埗闂</h3> <p>娴忚鍣ㄥ拰鏈嶅姟鍣ㄥURL害鏈夐鍒讹細</p> <ul> <li><strong>娴忚鍣ㄩ鍒讹細</strong>澶у鏁版祻瑙堝櫒闄愬埗URL害锟?000涓瓧绗乏锟?/li> <li><strong>鏈嶅姟鍣ㄩ鍒讹細</strong>Apache榛闄愬8190瀛妭锛ginx榛闄愬8KB</li> <li><strong>瑙ｅ喅鏂规硶锟�?/strong>瀵簬澶ч噺鏁版嵁锛屼娇鐢≒OST鏂硶灏嗘暟鎹斁鍦ㄨ姹備綋锟?/li> </ul> <div class="code-block"> # 涓嶆帹鑽愶細URL杩囬 GET /api/search?q=verylongquerywithlotsofparameters... # 鎺ㄨ崘锛娇鐢≒OST鏂硶 POST /api/search Content-Type: application/x-www-form-urlencoded q=verylongquerywithlotsofparameters... </div> <h3>4. 澶氳瑷�鏀寔闂</h3> <p>鍦ㄥ浗闄寲API涓紝闇�瑕佹敮鎸佸绉嶈瑷�的勬煡璇</p> <div class="code-block"> # 涓枃鏌 GET /api/search?q=%E4%B8%AD%E6%96%87 # 鏃ユ枃鏌 GET /api/search?q=%E6%97%A5%E6%96%87 # 闊╂枃鏌 GET /api/search?q=%E9%9F%A9%E6%96%87 # 娣峰悎鏌 GET /api/search?q=Hello%20World%20%E4%B8%AD%E6%96%87 </div> <h3>5. 鏃ユ湡鍜屾闂村弬鏁扮锟�?/h3> <p>鏃ユ湡鏃堕棿鍙傛暟闇�瑕伒狪SO 8601标准锟�?/p> <div class="code-block"> # 鎺ㄨ崘锛欼SO 8601鏍煎紡锛圲RL瀹叏锟�? GET /api/events?start=2026-01-01T00%3A00%3A00Z # 涓嶆帹鑽愶細鍏朵鏍煎 GET /api/events?start=2026/01/01%2012%3A00%3A00 # 鏃ユ湡鑼冨洿鏌ヨ GET /api/orders?from=2026-01-01&to=2026-12-31 </div> <h2>鍏�佸畨鍏�冭</h2> <h3>1. URL娉ㄥ叆鏀诲嚮</h3> <p>鏈纭鐞嗙殑URL缂栫爜鍙兘瀵艰嚧娉ㄥ叆诲嚮锟�?/p> <h4>SQL娉ㄥ叆庨</h4> <p>鍗充娇浣跨敤鍙傛暟鍖栨煡璇紝URL鍙傛暟涔熼渶瑕侀獙璇佸拰缂栫爜锟?/p> <div class="code-block"> # 舵剰杈撳 ?q=1%3BDROP%20TABLE%20users-- # 瑙ｇ爜鍚庡彲鑳介�犳垚鐮村潖 ?q=1;DROP TABLE users-- # 闃插尽鎺柦锛氫弗鏍奸獙璇佽锟�? def validate_param(param): allowed_chars = set('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_~') return all(c in allowed_chars for c in param) </div> <h3>2. XSS诲嚮椋庨</h3> <p>URL鍙傛暟鍙兘鍦ㄥ搷搴斾腑鍥炴樉锛岄渶瑕侀槻SS锟�?/p> <div class="code-block"> # 舵剰杈撳 ?q=<script>alert('xss')</script> # 缂栫爜鍚庡瓨锟�?鏄剧 ?q=%3Cscript%3Ealert%28%27xss%27%29%3C%2Fscript%3E # 鍦℉TML涓樉绀烘闇�瑕丠TML缂栫 <script>alert('xss')</script> </div> <h3>3. 鏁忔劅鏁版嵁澶勭</h3> <p>鏁忔劅鏁版嵁涓嶅簲璇ラ�氳繃URL浼犻�掞</p> <ul> <li><strong>瀵嗙爜锟?/strong>浣跨POST鏂硶鎴栬姹傚ご浼狅拷?/li> <li><strong>Token锟�?/strong>浼樺厛浣跨敤Authorization锟�?/li> <li><strong>鏁忔劅ID锟�?/strong>鑰冭檻鍔犲瘑鎴栦娇鐢ㄤ娆℃�ф爣璇嗙</li> </ul> <div class="code-block"> # 涓嶆帹鑽愶細氳繃URL浼犻�掓晱鎰熶俊锟�? GET /api/user/123?token=abc123&password=secret # 鎺ㄨ崘锛娇鐢姹傚 GET /api/user/123 Authorization: Bearer eyJhbGciOiJIUzI1NiIs... # 鎴栦娇鐢≒OST鏂硶 POST /api/login Content-Type: application/x-www-form-urlencoded username=user&password=secret </div> <h2>涓冦�佸疄鎴樻锟�?/h2> <h3>妗堜緥涓�锛悳绱㈠鑳藉紑锟�?/h3> <p>瀹炵幇涓�涓敮鎸佸璇█的勬悳绱PI锟�?/p> <div class="code-block"> # 璇锋眰绀轰緥 GET /api/v1/search?q=%E6%96%AF%E5%9D%97%E5%9B%BE%E5%BA%93&lang=zh&page=1&per_page=20 # Node.js瀹炵 app.get('/api/v1/search', async (req, res) => { const { q, lang = 'en', page = 1, per_page = 20 } = req.query; // 楠岃瘉鍙傛暟 if (!q || typeof q !== 'string') { return res.status(400).json({ error: 'Missing query parameter' }); } // 瑙ｇ爜骞堕獙璇佹煡锟? const query = decodeURIComponent(q); const pageNum = parseInt(page, 10); const limit = Math.min(parseInt(per_page, 10), 100); try { const results = await searchService.search({ query, language: lang, offset: (pageNum - 1) * limit, limit }); res.json({ success: true, data: results, pagination: { page: pageNum, per_page: limit, total: results.total } }); } catch (error) { res.status(500).json({ error: 'Search failed' }); } }); </div> <h3>妗堜緥浜岋細鏂囦欢涓婁紶API</h3> <p>瀹炵幇鏂囦涓婁紶API锛屾敞鎰忔枃浠跺悕缂爜锟?/p> <div class="code-block"> # 璇锋眰绀轰緥 POST /api/v1/files Content-Type: multipart/form-data file: (binary) filename: %E6%8A%A5%E5%91%8A-2026.pdf # Node.js瀹炵 const multer = require('multer'); const path = require('path'); const storage = multer.diskStorage({ destination: './uploads', filename: (req, file, cb) => { // 姝ｇ‘澶悊鏂囦鍚嶇紪锟�? const originalName = Buffer.from(file.originalname, 'latin1').toString('utf8'); const safeName = originalName.replace(/[^a-zA-Z0-9\u4e00-\u9fa5.-]/g, '_'); cb(null, `${Date.now()}-${safeName}`); } }); const upload = multer({ storage }); app.post('/api/v1/files', upload.single('file'), (req, res) => { res.json({ success: true, file: { id: req.file.filename, original_name: req.file.originalname, size: req.file.size } }); }); </div> <h2>鍏�佸伐鍏锋帹锟�?/h2> <p>鍦ˋPI�鍙戜腑锛屼娇鐢ㄥ悎傜殑宸ュ叿鍙互澶уぇ鎻愰鏁堢巼锟?/p> <p style="font-size: 18px;"><strong>🦘憠绔嵆浣跨敤锟�?/strong><a href="../tools/url-encode.html" style="font-weight: bold;">URL 缂栬В锟�?/a></p> <h3>�鍙戝伐鍏锋帹锟?/h3> <ul> <li><strong>Postman锟�?/strong>哄ぇ的凙PI娴宸ュ叿锛岃嚜鍔ㄥ鐞RL缂栫</li> <li><strong>curl锟�?/strong>鍛戒护琛屽伐鍏凤紝鏀寔鍚勭缂爜閫夐</li> <li><strong>在线URL缂栬В佸伐鍏凤</strong>蹇�熸祴璇曞拰璋冭</li> </ul> <h2>涔濄�佺粨锟?/h2> <p>URL缂栫爜鍦ˋPI�鍙戜腑鏄竴涓熀�浣嗛噸瑕佺殑涓婚銆傛纭鐞哢RL缂栫爜鍙互厤堝妫樻的棶棰橈紝鎻愰珮API的勫彲鐢ㄦ�у拰叏э?/p> <p>鏈枃鎬荤粨的勫叧閿偣锟�?/p> <ol> <li><strong>缁熶竴闆嗭</strong>粓浣跨敤UTF-8</li> <li><strong>浣跨敤标准噯搴擄</strong>涓嶈鑷繁鎵姩澶悊缂</li> <li><strong>厤閲嶅缂栫爜锟?/strong>鍙佷锟?/li> <li><strong>娉ㄦ剰璺緞鍙傛暟锟?/strong>璺緞涓殑鐗畩瀛闇�瑕侀澶栨敞锟�?/li> <li><strong>瀹叏绗竴锟?/strong>鏁忔劅鏁版嵁涓嶈閫氳繃URL浼狅?/li> <li><strong>娴鍚勭鍦烘櫙锟�?/strong>鍖呮涓枃銆佺娈婂瓧绗︺�佸璇█锟�?/li> </ol> <p>屾湜鏈枃鑳藉姪浣犳洿濂藉湴澶勭悊API�鍙戜腑的刄RL缂栫爜闂銆傚鏋滀綘鍦ㄥ疄闄呭伐浣腑閬囧埌浜嗗叾浠佺浉鍏崇殑闂锛屾杩庝娇鐢ㄦ垜浠殑在线URL缂栬В佸伐鍏疯繘琛岃皟璇曪?/p> <p style="font-size: 18px;"><strong>🦘憠绔嵆浣跨敤锟�?/strong><a href="../tools/url-encode.html" style="font-weight: bold;">URL 缂栬В锟�?/a></p> <div class="related-tools"> <h3>🦘洜锟�?鐩叧宸ュ叿鎺ㄨ崘</h3> <div class="tool-grid"> <div class="tool-card"> <h4>URL 缂栬В锟�?/h4> <p>缃戝潃涓庢枃鏈 URL 杞</p> <a href="../tools/url-encode.html">浣跨敤ュ</a> </div> <div class="tool-card"> <h4>Base64 缂栬В锟�?/h4> <p>鏂囨湰锟?Base64 鍙屽悜杞崲</p> <a href="../tools/base64.html">浣跨敤ュ</a> </div> <div class="tool-card"> <h4>JSON 鏍煎紡锟?/h4> <p>缇庡寲鍜岄獙锟�?JSON 鏁版</p> <a href="../tools/json.html">浣跨敤ュ</a> </div> <div class="tool-card"> <h4>姝ｅ琛ㄨ忔祴锟�?/h4> <p>在线ｅ琛ㄨ忔祴璇曞伐锟?/p> <a href="../tools/regex-tester.html">浣跨敤ュ</a> </div> <div class="tool-card"> <h4>鏃堕棿鎴宠浆锟�?/h4> <p>绉掔骇鏃堕棿鎴充笌鏈湴鏃ユ湡浜掕</p> <a href="../tools/timestamp.html">浣跨敤ュ</a> </div> <div class="tool-card"> <h4>浜岀佺敓鎴愬</h4> <p>鏂囨/缃戝潃涓�閿浆浜岀锟�?/p> <a href="../tools/qrcode.html">浣跨敤ュ</a> </div> <div class="tool-card"> <h4>MD5 鍔犲</h4> <p>灏嗕换鎰忔枃鏈浆鎹 MD5 鍝堝笇锟?/p> <a href="../tools/md5.html">浣跨敤ュ</a> </div> <div class="tool-card"> <h4>瀵嗙爜鐢熸垚锟�?/h4> <p>鍙皟闀害的畨鍏ㄥ瘑佺敓锟�?/p> <a href="../tools/password-generator.html">浣跨敤ュ</a> </div> </div> <div class="more-tools"> <a href="../index.html">🦘攳鏇村ュ</a> </div> </div> <div class="related-docs"> <h3>🦘摉鐩叧鏂囨。鎺ㄨ崘</h3> <ul class="doc-list"> <li> <h4><a href="url-encoding-complete-guide.html">URL缂栫爜屽叏鎸囧崡锛氫粠鍏ラ棬鍒扮簿閫氱殑鍏ㄩ潰瑙ｆ</a></h4> <p>璇︾粏浠粛URL缂栫爜的鏈蹇点�佺紪佽鍒欍�佸父瑙佸簲ㄥ満鏅�佸伐鍏蜂娇ㄦ妧宸э紝浠ュ強encodeURI鍜宔ncodeURIComponent的勫锟�?/p> </li> <li> <h4><a href="base64-complete-guide.html">Base64缂栬В佸畬鍏ㄦ寚鍗楋細浠庡鐞嗗埌搴旂敤的勫叏鏂逛綅瑙ｆ</a></h4> <p>璇︾粏浠粛Base64缂栬В佺殑宸ヤ綔鍘熺悊銆佺佽繃绋�佸父瑙佸簲ㄥ満鏅�佸伐鍏蜂娇ㄦ妧宸э紝姪�鍙戣�叏闈㈡帉鎻ase64鎶�锟�?/p> </li> <li> <h4><a href="json-formatting-guide.html">�鍙戣�澶囷細JSON鏍煎紡鍖栧畬鍏ㄦ寚鍗椻�斺�斾粠娣蜂贡鍒版鏅殑鐬棿杞</a></h4> <p>璇︾粏浠粛JSON鏍煎紡鍖殑閲嶈с�佸父瑙棶棰樸�佸伐鍏蜂娇鐢ㄦ妧宸с�佽皟璇曠粡岋紝甯姪�鍙戣�粠娣蜂贡的凧SON鏁版嵁涓揩熺悊鍑哄ご锟?/p> </li> <li> <h4><a href="timestamp-converter-guide.html">鏃堕棿鎴宠浆鎹㈡�庝箞鍋氾紵10锟�?13锟�?Unix 鏃堕棿鎴冲湪绾胯浆鎹㈡寚锟�?/a></h4> <p>璁茶В10浣嶄13浣嶆椂闂存埑鍖哄埆銆佹闂存埑杞棩鏈熸柟娉曘�佸8灏忔椂的父瑙佸師鍥狅紝骞舵彁渚涘绾挎椂闂存埑杞崲ュ叿鍏ュ彛</p> </li> </ul> <div class="all-docs"> <a href="index.html">🦘搫鎵�鏈枃锟�?/a> </div> </div> <div class="footer"> <a href="../index.html" class="back-link">杩斿洖棣</a> </div> </div> </div> </body> </html>