{"id":24618,"date":"2026-05-29T12:09:32","date_gmt":"2026-05-29T12:09:32","guid":{"rendered":"https:\/\/umang.pk\/2026\/05\/29\/%d8%a7%db%92-%d8%a2%d8%a6%db%8c-%d8%a7%db%8c%d8%ac%d9%86%d9%b9%d8%b3-%da%a9%db%92-%d9%84%db%8c%db%92-apis-%da%a9%db%8c%d8%b3%db%92-%da%88%db%8c%d8%b2%d8%a7%d8%a6%d9%86-%da%a9%d8%b1%db%8c%da%ba%db%94\/"},"modified":"2026-05-29T12:09:32","modified_gmt":"2026-05-29T12:09:32","slug":"%d8%a7%db%92-%d8%a2%d8%a6%db%8c-%d8%a7%db%8c%d8%ac%d9%86%d9%b9%d8%b3-%da%a9%db%92-%d9%84%db%8c%db%92-apis-%da%a9%db%8c%d8%b3%db%92-%da%88%db%8c%d8%b2%d8%a7%d8%a6%d9%86-%da%a9%d8%b1%db%8c%da%ba%db%94","status":"publish","type":"post","link":"https:\/\/umang.pk\/ur\/2026\/05\/29\/%d8%a7%db%92-%d8%a2%d8%a6%db%8c-%d8%a7%db%8c%d8%ac%d9%86%d9%b9%d8%b3-%da%a9%db%92-%d9%84%db%8c%db%92-apis-%da%a9%db%8c%d8%b3%db%92-%da%88%db%8c%d8%b2%d8%a7%d8%a6%d9%86-%da%a9%d8%b1%db%8c%da%ba%db%94\/","title":{"rendered":"\u0627\u06d2 \u0622\u0626\u06cc \u0627\u06cc\u062c\u0646\u0679\u0633 \u06a9\u06d2 \u0644\u06cc\u06d2 APIs \u06a9\u06cc\u0633\u06d2 \u0688\u06cc\u0632\u0627\u0626\u0646 \u06a9\u0631\u06cc\u06ba\u06d4"},"content":{"rendered":"\n<div id=\"\">\n<p>API \u06a9\u0648 \u0627\u0646\u0633\u0627\u0646\u06cc \u0688\u0648\u06cc\u0644\u067e\u0631\u0632 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0688\u06cc\u0632\u0627\u0626\u0646 \u06a9\u06cc\u0627 \u06af\u06cc\u0627 \u06c1\u06d2\u06d4 \u0644\u0648\u06af \u062c\u0627\u0646\u062a\u06d2 \u06c1\u06cc\u06ba \u06a9\u06c1 \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u0627\u062a \u06a9\u0648 \u06a9\u06cc\u0633\u06d2 \u067e\u0691\u06be\u0646\u0627 \u06c1\u06d2\u060c \u0627\u062e\u062a\u062a\u0627\u0645\u06cc \u0646\u0642\u0637\u0648\u06ba \u06a9\u06d2 \u067e\u06cc\u0686\u06be\u06d2 \u06a9\u06cc \u0646\u06cc\u062a \u06a9\u0627 \u0627\u0646\u062f\u0627\u0632\u06c1 \u0644\u06af\u0627\u0646\u0627 \u06c1\u06d2\u060c \u0627\u0648\u0631 \u062c\u0628 \u06a9\u0648\u0626\u06cc \u063a\u06cc\u0631 \u0645\u062a\u0648\u0642\u0639 \u0648\u0627\u0642\u0639\u06c1 \u067e\u06cc\u0634 \u0622\u062a\u0627 \u06c1\u06d2 \u062a\u0648 \u06a9\u0646\u0627\u0631\u06d2 \u06a9\u06d2 \u0645\u0639\u0627\u0645\u0644\u0627\u062a \u06a9\u0648 \u06c1\u06cc\u0646\u0688\u0644 \u06a9\u0631\u0646\u0627 \u06c1\u06d2\u06d4<\/p>\n<p>AI \u0627\u06cc\u062c\u0646\u0679\u0648\u06ba \u06a9\u06d2 \u067e\u0627\u0633 \u0648\u06c1 \u0633\u06cc\u0627\u0642 \u0648 \u0633\u0628\u0627\u0642 \u0627\u0648\u0631 \u0633\u0645\u062c\u06be \u0646\u06c1\u06cc\u06ba \u06c1\u06d2\u06d4<\/p>\n<p>AI \u0627\u06cc\u062c\u0646\u0679\u0633 \u0622\u067e \u06a9\u06d2 API \u06a9\u0648 \u0627\u0633\u06a9\u06cc\u0645\u0648\u06ba\u060c \u0645\u062b\u0627\u0644\u0648\u06ba\u060c \u0628\u06d2 \u062a\u0631\u062a\u06cc\u0628 \u0688\u06cc\u0679\u0627 \u0627\u0648\u0631 \u0631\u06cc\u0626\u0644 \u0679\u0627\u0626\u0645 \u062c\u0648\u0627\u0628\u0627\u062a \u06a9\u06d2 \u0630\u0631\u06cc\u0639\u06d2 \u0633\u0645\u062c\u06be\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4 \u062c\u0628 \u06a9\u0648\u0626\u06cc \u0639\u0645\u0644 \u06cc\u0627 \u0637\u0631\u06cc\u0642\u06c1 \u0645\u0628\u06c1\u0645 \u06cc\u0627 \u0645\u062a\u0636\u0627\u062f \u06c1\u0648\u062a\u0627 \u06c1\u06d2\u060c \u062a\u0648 \u0645\u0627\u0688\u0644 &#8216;\u0633\u0648\u0686\u0646\u06d2&#8217; \u06a9\u0648 \u062a\u0648\u0642\u0641 \u06a9\u06cc\u06d2 \u0628\u063a\u06cc\u0631 \u062e\u0627\u0644\u06cc \u062c\u06af\u06c1\u0648\u06ba \u06a9\u0648 \u067e\u064f\u0631 \u06a9\u0631\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<p>\u067e\u06cc\u062f\u0627\u0648\u0627\u0631\u06cc \u0645\u0627\u062d\u0648\u0644 \u0645\u06cc\u06ba\u060c \u0627\u0646 \u0627\u0646\u062f\u0627\u0632\u0648\u06ba \u06a9\u06d2 \u0646\u062a\u06cc\u062c\u06d2 \u0645\u06cc\u06ba \u0628\u0644\u0627\u06a9\u0646\u06af\u060c \u0637\u0648\u0641\u0627\u0646\u0648\u06ba \u06a9\u06cc \u062f\u0648\u0628\u0627\u0631\u06c1 \u06a9\u0648\u0634\u0634\u060c \u0646\u0642\u0644\u06cc \u0636\u0645\u0646\u06cc \u0627\u062b\u0631\u0627\u062a\u060c \u06cc\u0627 \u0648\u0631\u06a9 \u0641\u0644\u0648 \u0645\u06cc\u06ba \u062e\u0644\u0644 \u067e\u0691 \u0633\u06a9\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<p>\u06cc\u06c1\u06cc \u0648\u062c\u06c1 \u06c1\u06d2 \u06a9\u06c1 \u0627\u06cc\u0633\u06d2 APIs \u062c\u0648 \u0627\u0646\u0633\u0627\u0646\u0648\u06ba \u06a9\u06d2 \u0644\u06cc\u06d2 \u0628\u0627\u0644\u06a9\u0644 \u0679\u06be\u06cc\u06a9 \u06c1\u06cc\u06ba \u0627\u06a9\u062b\u0631 AI \u0627\u06cc\u062c\u0646\u0679\u0648\u06ba \u06a9\u0627 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u062a\u06d2 \u0648\u0642\u062a \u0646\u0627\u06a9\u0627\u0645 \u06c1\u0648 \u062c\u0627\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4 \u0645\u0633\u0626\u0644\u06c1 \u06cc\u06c1 \u0646\u06c1\u06cc\u06ba \u06c1\u06d2 \u06a9\u06c1 \u0627\u06cc\u062c\u0646\u0679 \u06a9\u0627\u0641\u06cc \u06c1\u0648\u0634\u06cc\u0627\u0631 \u0646\u06c1\u06cc\u06ba \u06c1\u06cc\u06ba\u06d4 APIs \u06a9\u0648 \u0627\u06a9\u062b\u0631 \u0627\u06cc\u062c\u0646\u0679\/\u0645\u0634\u06cc\u0646 \u0635\u0627\u0631\u0641\u06cc\u0646 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0688\u06cc\u0632\u0627\u0626\u0646 \u0646\u06c1\u06cc\u06ba \u06a9\u06cc\u0627 \u062c\u0627\u062a\u0627 \u06c1\u06d2 \u062c\u0646\u06c1\u06cc\u06ba \u0627\u0646\u0633\u0627\u0646\u06cc \u0645\u062f\u0627\u062e\u0644\u062a \u06a9\u06d2 \u0628\u063a\u06cc\u0631 \u0645\u0646\u0635\u0648\u0628\u06d2 \u0628\u0646\u0627\u0646\u06d2\u060c \u0679\u0648\u0644\u0632 \u06a9\u0627\u0644 \u06a9\u0631\u0646\u06d2 \u0627\u0648\u0631 \u063a\u0644\u0637\u06cc\u0648\u06ba \u0633\u06d2 \u0628\u0627\u0632\u06cc\u0627\u0641\u062a \u06a9\u0631\u0646\u06d2 \u06a9\u06cc \u0636\u0631\u0648\u0631\u062a \u06c1\u0648\u062a\u06cc \u06c1\u06d2\u06d4<\/p>\n<p>\u0627\u0633 \u06af\u0627\u0626\u06cc\u0688 \u0645\u06cc\u06ba\u060c \u0622\u067e \u0627\u06cc\u06a9 API \u0688\u06cc\u0632\u0627\u0626\u0646 \u06a9\u0631\u0646\u06d2 \u06a9\u0627 \u0637\u0631\u06cc\u0642\u06c1 \u0633\u06cc\u06a9\u06be\u06cc\u06ba \u06af\u06d2 \u062c\u0633\u06d2 \u0627\u06cc\u062c\u0646\u0679 \u0642\u0627\u0628\u0644 \u0627\u0639\u062a\u0645\u0627\u062f \u0637\u0631\u06cc\u0642\u06d2 \u0633\u06d2 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631 \u0633\u06a9\u06cc\u06ba\u06d4 \u06c1\u0645 \u062a\u06cc\u0646 \u0639\u0645\u0644\u06cc \u0646\u0638\u0631\u06cc\u0627\u062a \u06a9\u06d2 \u0633\u0627\u062a\u06be \u0628\u062d\u062b \u06a9\u06cc \u0631\u06c1\u0646\u0645\u0627\u0626\u06cc \u06a9\u0631\u06cc\u06ba \u06af\u06d2:<\/p>\n<ol>\n<li>\n<p><strong>\u0641\u06cc\u0635\u0644\u06c1 \u06a9\u0646 \u0627\u0642\u062f\u0627\u0645:<\/strong> \u0627\u06cc\u06a9 \u06c1\u06cc \u0622\u062f\u0627\u0646\u0648\u06ba \u0627\u0648\u0631 \u0631\u06cc\u0627\u0633\u062a\u0648\u06ba \u06a9\u0648 \u0645\u062a\u0648\u0642\u0639 \u0646\u062a\u0627\u0626\u062c \u0627\u0648\u0631 \u0634\u06a9\u0644\u06cc\u06ba \u067e\u06cc\u062f\u0627 \u06a9\u0631\u0646\u06cc \u0686\u0627\u06c1\u0626\u06cc\u06ba\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u0637\u0627\u0642\u062a\u0648\u0631 \u0633\u06a9\u06cc\u0645\u0627:<\/strong> \u0627\u06cc\u06a9 \u0645\u06a9\u0645\u0644\u060c \u0648\u0636\u0627\u062d\u062a\u06cc\u060c \u0627\u0648\u0631 \u0642\u0627\u0628\u0644 \u0627\u0645\u062a\u062d\u0627\u0646 \u0645\u0639\u0627\u06c1\u062f\u06c1\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>API \u0628\u0627\u0624\u0646\u0688\u0631\u06cc \u06a9\u06d2 \u0627\u0631\u062f \u06af\u0631\u062f \u06af\u0627\u0631\u0688\u0631\u06cc\u0644\u0632:<\/strong> \u063a\u06cc\u0631 \u0645\u062d\u0641\u0648\u0638 \u062e\u0648\u062f\u0645\u062e\u062a\u0627\u0631\u06cc \u06a9\u0648 \u0631\u0648\u06a9\u0646\u06d2 \u06a9\u06d2 \u0644\u06cc\u06d2 \u062a\u0635\u062f\u06cc\u0642\u060c \u062a\u0635\u062f\u06cc\u0642\u060c \u0627\u0648\u0631 \u0645\u062d\u0641\u0648\u0638 \u0688\u06cc\u0641\u0627\u0644\u0679\u0633\u06d4<\/p>\n<\/li>\n<\/ol>\n<p>\u0627\u0633 \u0645\u0636\u0645\u0648\u0646 \u06a9\u0627 \u0645\u0642\u0635\u062f &quot;AI-based&#8221; APIs \u0628\u0646\u0627\u0646\u0627 \u0646\u06c1\u06cc\u06ba \u06c1\u06d2\u060c \u0628\u0644\u06a9\u06c1 AI-based APIs \u0628\u0646\u0627\u0646\u0627 \u06c1\u06d2\u06d4 <strong>\u0648\u0627\u0636\u062d\u060c \u0633\u062e\u062a\u060c<\/strong> \u0627\u0648\u0631 <strong>\u0642\u0627\u0628\u0644 \u0627\u0639\u062a\u0645\u0627\u062f\u060c<\/strong> \u06cc\u06c1 \u0633\u0686 \u06c1\u06d2 \u06cc\u06c1\u0627\u06ba \u062a\u06a9 \u06a9\u06c1 \u0627\u06af\u0631 \u06a9\u0627\u0644 \u06a9\u0631\u0646\u06d2 \u0648\u0627\u0644\u0627 \u06a9\u0648\u0626\u06cc \u0627\u06cc\u062c\u0646\u0679 \u0646\u06c1\u06cc\u06ba \u06c1\u06d2 \u0628\u0644\u06a9\u06c1 \u0627\u06cc\u06a9 \u0633\u0627\u062a\u06be\u06cc \u0688\u0648\u06cc\u0644\u067e\u0631 \u06c1\u06d2 \u062c\u0648 \u0645\u062e\u062a\u0644\u0641 \u0679\u0648\u0644\u0632 \u06a9\u0627 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<h2 id=\"heading-table-of-contents\">\u0627\u0646\u0688\u06cc\u06a9\u0633<\/h2>\n<h2 id=\"heading-prerequisites\">\u0634\u0631\u0637\u06cc\u06ba<\/h2>\n<p>\u0627\u0633 \u06af\u0627\u0626\u06cc\u0688 \u06a9\u0648 \u067e\u0691\u06be\u0646\u06d2 \u0633\u06d2 \u067e\u06c1\u0644\u06d2\u060c \u062f\u0631\u062c \u0630\u06cc\u0644 \u06a9\u0648 \u062c\u0627\u0646\u0646\u0627 \u0645\u0641\u06cc\u062f \u06c1\u0648 \u06af\u0627:<\/p>\n<ul>\n<li>\n<p>HTTP API \u0627\u0648\u0631 REST \u062a\u0635\u0648\u0631\u0627\u062a \u06a9\u06cc \u0628\u0646\u06cc\u0627\u062f\u06cc \u062a\u0641\u06c1\u06cc\u0645<\/p>\n<\/li>\n<li>\n<p>JSON \u0627\u0648\u0631 API \u06a9\u06cc \u062f\u0631\u062e\u0648\u0627\u0633\u062a\/\u062c\u0648\u0627\u0628 \u06a9\u06d2 \u0646\u0645\u0648\u0646\u0648\u06ba \u06a9\u0627 \u0639\u0644\u0645\u06d4<\/p>\n<\/li>\n<li>\n<p>\u0639\u0627\u0645 API \u062a\u0635\u0648\u0631\u0627\u062a \u06a9\u06cc \u062a\u0641\u06c1\u06cc\u0645\u060c \u0628\u0634\u0645\u0648\u0644 \u062a\u0635\u062f\u06cc\u0642\u060c \u0635\u0641\u062d\u06c1 \u0628\u0646\u062f\u06cc\u060c \u0627\u0648\u0631 \u062f\u0648\u0628\u0627\u0631\u06c1 \u06a9\u0648\u0634\u0634\u06cc\u06ba\u06d4<\/p>\n<\/li>\n<\/ul>\n<h2 id=\"heading-why-good-enough-for-devs-is-not-good-enough-for-agents\">\u06a9\u06cc\u0648\u06ba &quot;\u0688\u0648\u06cc\u0644\u067e\u0631\u0632 \u06a9\u06d2 \u0644\u06cc\u06d2 \u06a9\u0627\u0641\u06cc \u0627\u0686\u06be\u0627&#8221; \u0627\u06cc\u062c\u0646\u0679\u0648\u06ba \u06a9\u06d2 \u0644\u06cc\u06d2 \u06a9\u0627\u0641\u06cc \u0627\u0686\u06be\u0627 \u0646\u06c1\u06cc\u06ba \u06c1\u06d2\u06d4<\/h2>\n<p>\u0627\u0646\u0633\u0627\u0646\u06cc \u0688\u0648\u06cc\u0644\u067e\u0631 \u062e\u0627\u0645\u0648\u0634\u060c \u0633\u06cc\u0627\u0642 \u0648 \u0633\u0628\u0627\u0642 \u06a9\u0627 \u0639\u0644\u0645 \u0644\u0627\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4 \u0648\u06c1 \u0633\u0644\u06cc\u06a9 \u062a\u06be\u0631\u06cc\u0688\u0632 \u067e\u0691\u06be\u062a\u06d2 \u06c1\u06cc\u06ba\u060c \u0648\u06c1 \u0628\u0644\u0627\u06af \u067e\u0648\u0633\u0679\u0633 \u067e\u0691\u06be\u062a\u06d2 \u06c1\u06cc\u06ba\u060c \u0627\u0648\u0631 \u0627\u0646\u06c1\u06cc\u06ba \u0627\u062d\u0633\u0627\u0633 \u06c1\u0648\u062a\u0627 \u06c1\u06d2\u060c &quot;\u0627\u0633 404 \u06a9\u0627 \u0639\u0627\u0645 \u0637\u0648\u0631 \u067e\u0631 \u0645\u0637\u0644\u0628 \u06c1\u06d2 \u06a9\u06c1 \u0622\u067e \u0627\u067e\u0646\u06cc \u0648\u0631\u06a9 \u0627\u0633\u067e\u06cc\u0633 ID \u0628\u06be\u0648\u0644 \u06af\u0626\u06d2 \u06c1\u06cc\u06ba\u06d4&#8221;<\/p>\n<p>\u0627\u06cc\u062c\u0646\u0679\u0648\u06ba \u06a9\u0648 \u0632\u06cc\u0627\u062f\u06c1 \u062a\u0631 \u062a\u0641\u0635\u06cc\u0644\u0627\u062a\u060c \u0645\u062b\u0627\u0644\u0648\u06ba \u0627\u0648\u0631 \u062d\u062a\u0645\u06cc \u062c\u0648\u0627\u0628 \u06a9\u06d2 \u0628\u0627\u0688\u06cc \u0645\u06cc\u06ba \u0633\u0628 \u06a9\u0686\u06be \u0645\u0644\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<p>\u062e\u0644\u0627 \u062e\u0648\u062f \u06a9\u0648 \u067e\u06cc\u0634\u06cc\u0646 \u06af\u0648\u0626\u06cc \u06a9\u06d2 \u0637\u0631\u06cc\u0642\u0648\u06ba \u0633\u06d2 \u0638\u0627\u06c1\u0631 \u06a9\u0631\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<ul>\n<li>\n<p><strong>\u0645\u0628\u06c1\u0645 \u0645\u0639\u0646\u06cc:<\/strong> \u063a\u0644\u0637 \u0627\u062e\u062a\u062a\u0627\u0645\u06cc \u0646\u0642\u0637\u06c1 \u06cc\u0627 \u063a\u0644\u0637 \u067e\u06cc\u0631\u0627\u0645\u06cc\u0679\u0631 \u0645\u062c\u0645\u0648\u0639\u06c1\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u063a\u06cc\u0631 \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u06cc \u0634\u0627\u062e\u06cc\u06ba:<\/strong> \u0645\u0627\u0688\u0644 \u0627\u06cc\u06a9 \u0641\u06cc\u0644\u0688 \u0627\u06cc\u062c\u0627\u062f \u06a9\u0631\u062a\u0627 \u06c1\u06d2 \u06cc\u0627 \u0627\u062e\u062a\u06cc\u0627\u0631\u06cc \u0639\u0645\u0644 \u06a9\u0648 \u063a\u0644\u0637 \u067e\u0691\u06be\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u0645\u062a\u0636\u0627\u062f \u062e\u0631\u0627\u0628\u06cc \u06a9\u0627 \u0628\u0627\u0688\u06cc:<\/strong> \u06cc\u06c1 \u06cc\u0627 \u062a\u0648 \u062f\u0648\u0628\u0627\u0631\u06c1 \u06a9\u0648\u0634\u0634 \u06c1\u06d2 \u062c\u0648 \u0646\u06c1\u06cc\u06ba \u06c1\u0648\u0646\u06cc \u0686\u0627\u06c1\u06cc\u06d2\u060c \u06cc\u0627 \u062f\u0648\u0628\u0627\u0631\u06c1 \u06a9\u0648\u0634\u0634 \u0646\u06c1\u06cc\u06ba \u06c1\u0648 \u0631\u06c1\u06cc \u06c1\u06d2 \u062c\u0628 \u0627\u06cc\u0633\u0627 \u06a9\u0631\u0646\u0627 \u0645\u062d\u0641\u0648\u0638 \u06c1\u0648\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u063a\u06cc\u0631 \u0645\u0642\u0644\u062f &quot;\u06a9\u0627\u0645 \u06a9\u0631\u062a\u0627 \u06c1\u06d2&#8221; \u0627\u062e\u062a\u062a\u0627\u0645\u06cc \u0646\u0642\u0637\u06c1:<\/strong> \u0688\u067e\u0644\u06cc\u06a9\u06cc\u0679 \u0686\u0627\u0631\u062c\u0632\u060c \u0688\u067e\u0644\u06cc\u06a9\u06cc\u0679 \u0679\u06a9\u0679\u060c \u0688\u067e\u0644\u06cc\u06a9\u06cc\u0679 \u0627\u06cc \u0645\u06cc\u0644\u0632\u06d4<\/p>\n<\/li>\n<\/ul>\n<p>\u0635\u0646\u0639\u062a \u06a9\u06cc \u062a\u0641\u0633\u06cc\u0631 \u0627\u0648\u0631 \u067e\u0631\u06cc\u06a9\u0679\u06cc\u0634\u0646\u0631 \u06af\u0627\u0626\u06cc\u0688\u0632 \u0627\u06cc\u06a9 \u06c1\u06cc \u0646\u06a9\u062a\u06d2 \u067e\u0631 \u0627\u06a9\u0679\u06be\u06d2 \u06c1\u0648\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4 \u0627\u06cc\u062c\u0646\u0679 API \u0635\u0627\u0631\u0641\u06cc\u0646 \u06a9\u06cc \u0627\u06cc\u06a9 \u0628\u0691\u06cc \u06a9\u0644\u0627\u0633 \u0628\u0646 \u0631\u06c1\u06d2 \u06c1\u06cc\u06ba\u060c \u0627\u0648\u0631 \u0645\u0634\u06cc\u0646 \u06a9\u06cc \u067e\u0691\u06be\u0646\u06d2 \u06a9\u06cc \u0627\u06c1\u0644\u06cc\u062a \u0627\u062a\u0646\u06cc \u06c1\u06cc \u0627\u06c1\u0645 \u06c1\u06d2 \u062c\u062a\u0646\u06cc \u0688\u0648\u06cc\u0644\u067e\u0631 \u06a9\u06d2 \u062a\u062c\u0631\u0628\u06d2 \u06a9\u06cc \u06c1\u06d2\u06d4<\/p>\n<p>\u0627\u0633 \u062f\u0633\u062a\u0627\u0648\u06cc\u0632 \u06a9\u06d2 \u0622\u062e\u0631 \u0645\u06cc\u06ba \u062f\u0631\u062c \u0648\u0633\u0627\u0626\u0644 \u0645\u06cc\u06ba \u0627\u06cc\u062c\u0646\u0679\u0648\u06ba\u060c \u0646\u0626\u06d2 \u0679\u0648\u0644 \u067e\u0631\u0648\u0679\u0648\u06a9\u0648\u0644\u0632\u060c \u0627\u0648\u0631 \u0679\u0631\u06cc\u0641\u06a9 \u06a9\u06d2 \u0646\u0645\u0648\u0646\u0648\u06ba \u06a9\u06d2 \u0628\u0627\u0631\u06d2 \u0645\u06cc\u06ba \u0645\u0639\u0644\u0648\u0645\u0627\u062a \u06a9\u06d2 \u0630\u0631\u06cc\u0639\u06c1 OpenAPI \u06a9\u06d2 \u0628\u0627\u0631\u06d2 \u0645\u06cc\u06ba \u0628\u062d\u062b \u06a9\u06cc \u0645\u062b\u0627\u0644\u06cc\u06ba \u062f\u06cc\u06a9\u06be\u06cc\u06ba \u062c\u0648 \u0627\u0646\u0633\u0627\u0646\u06cc \u06a9\u0644\u0627\u0626\u0646\u0679\u0633 \u0633\u06d2 \u0645\u062e\u062a\u0644\u0641 \u06c1\u06cc\u06ba\u06d4<\/p>\n<h2 id=\"heading-principle-1-deterministic-behavior\">\u0627\u0635\u0648\u0644 1: \u062a\u0639\u06cc\u06cc\u0646\u0627\u062a\u06cc \u0631\u0648\u06cc\u06c1<\/h2>\n<p>\u0627\u06cc\u062c\u0646\u0679 \u06a9\u06d2 \u0639\u0632\u0645 \u06a9\u0627 \u0645\u0637\u0644\u0628 \u06cc\u06c1 \u0646\u06c1\u06cc\u06ba \u06c1\u06d2 \u06a9\u06c1 \u06cc\u06c1 &quot;\u06c1\u0645\u06cc\u0634\u06c1 \u0627\u06cc\u06a9 \u06c1\u06cc JSON \u06a9\u0648 \u06c1\u0645\u06cc\u0634\u06c1 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0648\u0627\u067e\u0633 \u06a9\u0631\u06d2 \u06af\u0627&#8221;\u06d4 \u0627\u0633 \u06a9\u0627 \u0645\u0637\u0644\u0628 \u06c1\u06d2: <strong>\u0627\u06cc\u06a9 \u06c1\u06cc \u062f\u0631\u062e\u0648\u0627\u0633\u062a \u0627\u0648\u0631 \u0627\u06cc\u06a9 \u06c1\u06cc \u0633\u0631\u0648\u0631 \u0633\u0627\u0626\u06cc\u0688 \u062d\u0627\u0644\u062a \u06a9\u0648 \u062f\u06cc\u06a9\u06be\u062a\u06d2 \u06c1\u0648\u0626\u06d2\u060c API \u0627\u0633 \u0637\u0631\u062d \u0628\u0631\u062a\u0627\u0624 \u06a9\u0631\u062a\u0627 \u06c1\u06d2 \u062c\u0633 \u06a9\u0627 \u0627\u06cc\u062c\u0646\u0679 \u0645\u0627\u0688\u0644 \u0628\u0646\u0627 \u0633\u06a9\u062a\u0627 \u06c1\u06d2\u06d4<\/strong> \u0627\u06af\u0631 \u0631\u06cc\u0627\u0633\u062a \u0628\u062f\u0644\u062a\u06cc \u06c1\u06d2 \u062a\u0648 \u0627\u0633\u06d2 \u0648\u0627\u0636\u062d \u0637\u0648\u0631 \u067e\u0631 \u0628\u06cc\u0627\u0646 \u06a9\u0631\u06cc\u06ba\u06d4<\/p>\n<h3 id=\"heading-prefer-explicit-state-over-hidden-magic\">\u067e\u0648\u0634\u06cc\u062f\u06c1 \u062c\u0627\u062f\u0648 \u067e\u0631 \u0648\u0627\u0636\u062d \u062d\u0627\u0644\u062a \u06a9\u0648 \u062a\u0631\u062c\u06cc\u062d \u062f\u06cc\u06ba\u06d4<\/h3>\n<p>\u0627\u06cc\u062c\u0646\u0679 &quot;\u0628\u0639\u0636 \u0627\u0648\u0642\u0627\u062a \u0633\u0631\u0648\u0631 \u0627\u0646\u062f\u0631\u0648\u0646\u06cc \u067e\u0631\u0686\u0645 \u06a9\u06cc \u0628\u0646\u06cc\u0627\u062f \u067e\u0631 X \u06a9\u0631\u062a\u0627 \u06c1\u06d2&#8221; \u06a9\u06d2 \u0633\u0627\u062a\u06be \u062c\u062f\u0648\u062c\u06c1\u062f \u06a9\u0631\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4 \u062c\u06c1\u0627\u06ba \u0627\u0646\u0633\u0627\u0646 \u067e\u0631\u0648\u0688\u06a9\u0679 \u06a9\u0627\u067e\u06cc \u0633\u06d2 \u0646\u06cc\u062a \u06a9\u0627 \u0627\u0646\u062f\u0627\u0632\u06c1 \u0644\u06af\u0627\u062a\u06d2 \u06c1\u06cc\u06ba\u060c \u0627\u06cc\u062c\u0646\u0679 \u067e\u06cc\u0679\u0631\u0646 \u0633\u06d2 \u0627\u0646\u062f\u0627\u0632\u06c1 \u0644\u06af\u0627\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4 \u062c\u0628 \u06cc\u06c1 \u0646\u0645\u0648\u0646\u06d2 \u0628\u0691\u06be\u062a\u06d2 \u06c1\u06cc\u06ba \u062a\u0648 \u062e\u0648\u062f \u0645\u062e\u062a\u0627\u0631\u06cc \u0679\u0648\u0679 \u062c\u0627\u062a\u06cc \u06c1\u06d2\u06d4<\/p>\n<p>\u0639\u0645\u0644\u06cc \u0639\u0627\u062f\u0627\u062a:<\/p>\n<ul>\n<li>\n<p>\u0645\u0627\u0688\u0644 \u0644\u0627\u0626\u0641 \u0633\u0627\u0626\u06cc\u06a9\u0644 \u06a9\u0648 \u0648\u0627\u0636\u062d \u0637\u0648\u0631 \u067e\u0631 \u0628\u06cc\u0627\u0646 \u06a9\u0631\u06cc\u06ba (<code>draft<\/code> \u2192 <code>submitted<\/code> \u2192 <code>approved<\/code>) \u0627\u06cc\u06a9 \u0633\u0646\u06af\u0644 \u06a9\u0648 \u0627\u0648\u0648\u0631 \u0644\u0648\u0688 \u06a9\u0631\u0646\u06d2 \u06a9\u06d2 \u0628\u062c\u0627\u0626\u06d2 <code>status<\/code> \u063a\u06cc\u0631 \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u06cc \u0627\u0645\u062a\u0632\u0627\u062c \u06a9\u06d2 \u0633\u0627\u062a\u06be \u0641\u06cc\u0644\u0688\u0632\u06d4<\/p>\n<\/li>\n<li>\n<p>\u062a\u0628\u062f\u06cc\u0644\u06cc \u06a9\u06d2 \u0628\u0639\u062f \u062c\u0648 \u06a9\u0686\u06be \u0628\u062f\u0644\u0627 \u06c1\u06d2 \u0648\u06c1 \u0644\u0648\u0679\u0627\u062a\u0627 \u06c1\u06d2 (\u0627\u067e \u0688\u06cc\u0679 \u06a9\u0631\u062f\u06c1 \u0648\u0633\u0627\u0626\u0644\u060c \u0645\u0646\u0633\u0644\u06a9 ID\u060c \u0627\u06af\u0644\u06cc \u0627\u062c\u0627\u0632\u062a \u0634\u062f\u06c1 \u06a9\u0627\u0631\u0631\u0648\u0627\u0626\u06cc)\u06d4<\/p>\n<\/li>\n<li>\n<p>\u062e\u0648\u062f\u06a9\u0627\u0631 \u0646\u0641\u0627\u0630 \u0633\u06d2 \u06af\u0631\u06cc\u0632 \u06a9\u0631\u06cc\u06ba (\u063a\u0644\u0637 \u0634\u0645\u0627\u0631\u0648\u06ba \u06a9\u0648 \u062e\u0648\u062f \u0628\u062e\u0648\u062f \u062f\u0631\u0633\u062a \u06a9\u0631\u0646\u0627\u060c \u0646\u0627\u0645\u0639\u0644\u0648\u0645 \u0641\u06cc\u0644\u0688\u0632 \u06a9\u0648 \u062e\u0648\u062f \u0628\u062e\u0648\u062f \u062d\u0630\u0641 \u06a9\u0631\u0646\u0627) \u062c\u0628 \u062a\u06a9 \u06a9\u06c1 \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u06cc \u0627\u0648\u0631 \u0633\u06af\u0646\u0644 \u0646\u06c1 \u06c1\u0648\u06ba\u06d4<\/p>\n<\/li>\n<\/ul>\n<h3 id=\"heading-make-writes-safe-idempotency-and-intent-keys\">\u0644\u06a9\u06be\u0646\u06d2 \u06a9\u0648 \u0645\u062d\u0641\u0648\u0638 \u0628\u0646\u0627\u0646\u0627: \u0627\u062f\u0631\u0627\u06a9 \u0627\u0648\u0631 \u0627\u0631\u0627\u062f\u06d2 \u06a9\u06cc \u0686\u0627\u0628\u06cc\u0627\u06ba<\/h3>\n<p>\u062a\u0645\u0627\u0645 \u0627\u06cc\u0646\u0688 \u067e\u0648\u0627\u0626\u0646\u0679\u0633 \u06a9\u06d2 \u0644\u06cc\u06d2\u060c \u0628\u0634\u0645\u0648\u0644 \u0628\u0644\u0646\u06af\u060c \u0645\u06cc\u0633\u062c\u0646\u06af\u060c \u067e\u0631\u0648\u0648\u06cc\u0698\u0646\u0646\u06af \u0627\u0646\u0641\u0631\u0627\u0633\u0679\u0631\u06a9\u0686\u0631 \u0648\u063a\u06cc\u0631\u06c1\u06d4 <strong>\u0645\u06cc\u06ba \u06a9\u0686\u06be \u0627\u06cc\u0633\u0627 \u06a9\u0631 \u0631\u06c1\u0627 \u06c1\u0648\u06ba \u062c\u0633\u06d2 \u06a9\u0627\u0644\u0639\u062f\u0645 \u0646\u06c1\u06cc\u06ba \u06a9\u06cc\u0627 \u062c\u0627 \u0633\u06a9\u062a\u0627<\/strong>\u0641\u0631\u0636 \u06a9\u0631\u06cc\u06ba \u06a9\u06c1 \u062f\u0648\u06c1\u0631\u06cc \u06af\u0630\u0627\u0631\u0634\u0627\u062a \u06c1\u0648\u062a\u06cc \u06c1\u06cc\u06ba\u06d4<\/p>\n<ul>\n<li>\n<p>\u062a\u062e\u0644\u06cc\u0642 \u06a9\u06cc \u0637\u0631\u062d \u06a9\u06cc \u06a9\u0627\u0631\u0631\u0648\u0627\u0626\u06cc\u0648\u06ba \u06a9\u06d2 \u0644\u06cc\u06d2 \u0622\u0626\u06cc\u0688\u06cc\u0645\u067e\u0648\u0679\u06cc\u0646\u0679 \u06a9\u06cc\u0632 (\u06c1\u06cc\u0688\u0631 \u06cc\u0627 \u0628\u0627\u0688\u06cc) \u06a9\u0648 \u0633\u067e\u0648\u0631\u0679 \u06a9\u0631\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<\/li>\n<li>\n<p>\u0648\u0627\u0636\u062d HTTP \u0633\u06cc\u0645\u0646\u0679\u06a9\u0633 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u06cc\u06ba\u06d4 <code>POST<\/code> \u0628\u0646\u0627\u0626\u06cc\u06ba <code>PUT<\/code> \u062c\u06c1\u0627\u06ba \u0645\u0646\u0627\u0633\u0628 \u06c1\u0648 \u062a\u0628\u062f\u06cc\u0644 \u06a9\u0631\u06cc\u06ba\u061b <code>PATCH<\/code> \u062c\u0632\u0648\u06cc \u0627\u067e \u0688\u06cc\u0679\u0633 \u06a9\u06d2 \u0644\u06cc\u06d2\u060c \u062f\u0633\u062a\u0627\u0648\u06cc\u0632 \u06a9\u0631\u06cc\u06ba \u06a9\u06c1 \u062a\u06a9\u0631\u0627\u0631 \u06a9\u0627 \u06a9\u06cc\u0627 \u0645\u0637\u0644\u0628 \u06c1\u06d2\u06d4<\/p>\n<\/li>\n<li>\n<p>\u0627\u06af\u0631 \u0627\u0648\u0648\u0631\u0644\u06cc\u067e \u0645\u0645\u06a9\u0646 \u06c1\u0648 \u062a\u0648 \u06a9\u0644\u0627\u0626\u0646\u0679 \u0631\u06cc\u0641\u0631\u0644 \u06a9\u06d2 \u0630\u0631\u06cc\u0639\u06d2 \u0631\u06cc\u0641\u0631\u0644 \u067e\u0627\u062a\u06be \u0641\u0631\u0627\u06c1\u0645 \u06a9\u0631\u06cc\u06ba \u062a\u0627\u06a9\u06c1 \u0627\u06cc\u062c\u0646\u0679 \u0627\u06cc\u0688\u062c\u0633\u0679\u0645\u0646\u0679 \u06a9\u0631 \u0633\u06a9\u06cc\u06ba\u06d4<\/p>\n<\/li>\n<\/ul>\n<h3 id=\"heading-pagination-and-sorting-one-pattern-everywhere\">\u0635\u0641\u062d\u06c1 \u0628\u0646\u062f\u06cc \u0627\u0648\u0631 \u0686\u06be\u0627\u0646\u0679\u0646\u0627: \u0627\u06cc\u06a9 \u067e\u06cc\u0679\u0631\u0646\u060c \u06c1\u0631 \u062c\u06af\u06c1<\/h3>\n<p>\u0627\u06cc\u062c\u0646\u0679 \u0644\u0648\u067e. \u0627\u06af\u0631 \u062a\u0645\u0627\u0645 \u0648\u0633\u0627\u0626\u0644 \u06a9\u0648 \u0645\u062e\u062a\u0644\u0641 \u0637\u0631\u06cc\u0642\u06d2 \u0633\u06d2 \u0635\u0641\u062d\u06c1 \u0628\u0646\u062f\u06cc \u06a9\u06cc\u0627 \u062c\u0627\u062a\u0627 \u06c1\u06d2\u060c \u062a\u0648 \u0645\u0627\u0688\u0644 \u062d\u06a9\u0645\u062a \u0639\u0645\u0644\u06cc\u0648\u06ba \u06a9\u0648 \u0645\u0644\u0627 \u062f\u06cc\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<p>\u0627\u0633 \u0645\u0633\u0626\u0644\u06d2 \u06a9\u0648 \u062d\u0644 \u06a9\u0631\u0646\u06d2 \u06a9\u06d2 \u0644\u06cc\u06d2\u060c \u0641\u06cc API \u0633\u0637\u062d \u067e\u0631 \u0627\u06cc\u06a9 \u0635\u0641\u062d\u06c1 \u0628\u0646\u062f\u06cc \u06a9\u0627 \u0627\u0646\u062f\u0627\u0632 (\u06a9\u0631\u0633\u0631 \u0628\u0645\u0642\u0627\u0628\u0644\u06c1 \u0622\u0641\u0633\u06cc\u0679) \u0645\u0646\u062a\u062e\u0628 \u06a9\u0631\u06cc\u06ba \u0627\u0648\u0631 \u0627\u0633 \u067e\u0631 \u0642\u0627\u0626\u0645 \u0631\u06c1\u06cc\u06ba\u06d4<\/p>\n<p>\u06cc\u06c1 \u06c1\u0645\u06cc\u0634\u06c1 \u0648\u0627\u067e\u0633 \u0622\u062a\u0627 \u06c1\u06d2 \u06cc\u0627 \u0627\u06cc\u06a9 \u0645\u0633\u062a\u062d\u06a9\u0645 \u062a\u0631\u062a\u06cc\u0628 \u06a9\u06cc \u0636\u0631\u0648\u0631\u062a \u06c1\u0648\u062a\u06cc \u06c1\u06d2\u06d4 <code>sort<\/code> \u0648\u0627\u0636\u062d \u0637\u0648\u0631 \u067e\u0631\u06d4 \u0622\u067e \u06a9\u0648 \u0628\u06be\u06cc \u0634\u0627\u0645\u0644 \u06a9\u0631\u0646\u0627 \u0686\u0627\u06c1\u0626\u06d2\u06d4 <code>next<\/code> \u0645\u0633\u0644\u0633\u0644 \u0644\u0641\u0627\u0641\u06d2 \u0645\u06cc\u06ba \u0644\u0646\u06a9 \u06cc\u0627 \u06a9\u0631\u0633\u0631\u06d4<\/p>\n<h3 id=\"heading-timeouts-partial-success-and-async-work\">\u0679\u0627\u0626\u0645 \u0622\u0624\u0679\u060c \u062c\u0632\u0648\u06cc \u06a9\u0627\u0645\u06cc\u0627\u0628\u06cc\u060c \u0627\u0648\u0631 \u063a\u06cc\u0631 \u0645\u0637\u0627\u0628\u0642\u062a \u067e\u0630\u06cc\u0631 \u0622\u067e\u0631\u06cc\u0634\u0646\u0632<\/h3>\n<p>\u0627\u06cc\u062c\u0646\u0679\u0648\u06ba \u06a9\u0648 \u0646\u0641\u0631\u062a \u06c1\u06d2 &quot;\u062c\u0633 \u0646\u06d2 \u0634\u0627\u06cc\u062f \u06a9\u0627\u0645 \u06a9\u06cc\u0627\u06d4&#8221; \u0627\u06cc\u06a9 \u0637\u0648\u06cc\u0644 \u0639\u0631\u0635\u06d2 \u0633\u06d2 \u0686\u0644\u0646\u06d2 \u0648\u0627\u0644\u06d2 \u06a9\u0627\u0645 \u06a9\u0648: <strong>\u0648\u0627\u0636\u062d \u0637\u0648\u0631 \u067e\u0631 \u063a\u06cc\u0631 \u0645\u0637\u0627\u0628\u0642\u062a \u067e\u0630\u06cc\u0631<\/strong>:<\/p>\n<ul>\n<li>\n<p><code>202 Accepted<\/code>    + \u062c\u0627\u0628 \u0622\u0626\u06cc \u0688\u06cc + \u067e\u0648\u0644\u0646\u06af \u06cc\u0627 \u0648\u06cc\u0628 \u06c1\u06a9\u06d4<\/p>\n<\/li>\n<li>\n<p>\u0679\u0631\u0645\u06cc\u0646\u0644 \u06a9\u06cc \u062d\u0627\u0644\u062a \u0635\u0627\u0641 \u06a9\u0631\u06cc\u06ba: <code>succeeded<\/code>\u060c <code>failed<\/code>\u060c <code>canceled<\/code>\u0646\u0627\u06a9\u0627\u0645\u06cc \u06a9\u06d2 \u0644\u06cc\u06d2 \u0633\u0627\u062e\u062a\u06cc \u062e\u0631\u0627\u0628\u06cc \u06a9\u06cc \u062a\u0641\u0635\u06cc\u0644\u0627\u062a \u067e\u0631 \u0645\u0634\u062a\u0645\u0644 \u06c1\u06d2\u06d4<\/p>\n<\/li>\n<\/ul>\n<h2 id=\"heading-principle-2-strong-schemas\">\u0627\u0635\u0648\u0644 2: \u0645\u0636\u0628\u0648\u0637 \u0627\u0633\u06a9\u06cc\u0645\u0627<\/h2>\n<p>\u0627\u06af\u0631 \u0639\u0632\u0645 \u0631\u0648\u06cc\u06d2 \u06a9\u06d2 \u0628\u0627\u0631\u06d2 \u0645\u06cc\u06ba \u06c1\u06d2\u060c \u062a\u0648 \u0627\u0633\u06a9\u06cc\u0645\u0627 \u0645\u0648\u0627\u0635\u0644\u0627\u062a \u06a9\u06d2 \u0628\u0627\u0631\u06d2 \u0645\u06cc\u06ba \u06c1\u06cc\u06ba\u06d4 \u0627\u06cc\u062c\u0646\u0679\u0648\u06ba \u06a9\u06d2 \u0644\u06cc\u06d2\u060c OpenAPI (\u06cc\u0627 \u0645\u0633\u0627\u0648\u06cc) \u0631\u0646 \u0679\u0627\u0626\u0645 \u0627\u0646\u0679\u0631\u0641\u06cc\u0633 \u06a9\u0627 \u062d\u0635\u06c1 \u06c1\u06d2\u060c \u06a9\u0627\u063a\u0630\u06cc \u06a9\u0627\u0631\u0631\u0648\u0627\u0626\u06cc \u06a9\u0627 \u0646\u06c1\u06cc\u06ba\u06d4<\/p>\n<h3 id=\"heading-treat-openapi-as-a-contract-not-a-souvenir\">OpenAPI \u06a9\u0648 \u0627\u06cc\u06a9 \u0645\u0639\u0627\u06c1\u062f\u06d2 \u06a9\u06d2 \u0637\u0648\u0631 \u067e\u0631 \u0633\u0645\u062c\u06be\u06cc\u06ba\u060c \u0646\u06c1 \u06a9\u06c1 \u0627\u06cc\u06a9 \u06cc\u0627\u062f\u06af\u0627\u0631\u06d4<\/h3>\n<p>\u0627\u06cc\u06a9 \u0642\u06cc\u0627\u0633 \u062c\u0648 \u067e\u06cc\u062f\u0627\u0648\u0627\u0631 \u0645\u06cc\u06ba \u062a\u0627\u062e\u06cc\u0631 \u06a9\u0631\u062a\u0627 \u06c1\u06d2 \u0648\u06c1 \u0628\u063a\u06cc\u0631 \u06a9\u0633\u06cc \u0642\u06cc\u0627\u0633 \u0633\u06d2 \u0628\u062f\u062a\u0631 \u06c1\u06d2\u06d4 \u06cc\u06c1 \u0627\u06cc\u062c\u0646\u0679\u0648\u06ba \u06a9\u0648 \u0627\u0639\u062a\u0645\u0627\u062f \u06a9\u06d2 \u0633\u0627\u062a\u06be \u063a\u0644\u0637 \u06c1\u0648\u0646\u06d2 \u06a9\u06cc \u062a\u0631\u0628\u06cc\u062a \u062f\u06cc\u062a\u0627 \u06c1\u06d2\u06d4 \u0679\u06cc\u0645\u06cc\u06ba \u062a\u06cc\u0632\u06cc \u0633\u06d2 OpenAPI \u06a9\u0648 \u0627\u06cc\u06a9 \u0645\u0633\u062a\u0646\u062f \u0645\u0639\u0627\u06c1\u062f\u06c1 \u06a9\u06d2 \u0637\u0648\u0631 \u067e\u0631 \u062f\u06cc\u06a9\u06be \u0631\u06c1\u06cc \u06c1\u06cc\u06ba \u0627\u0648\u0631 CI \u0627\u0648\u0631 \u06a9\u0646\u0627\u0631\u06d2 \u067e\u0631 \u0627\u0633 \u06a9\u06d2 \u062e\u0644\u0627\u0641 \u062f\u0631\u062e\u0648\u0627\u0633\u062a\u0648\u06ba\/\u062c\u0648\u0627\u0628\u0627\u062a \u06a9\u06cc \u062a\u0648\u062b\u06cc\u0642 \u06a9\u0631 \u0631\u06c1\u06cc \u06c1\u06cc\u06ba\u06d4<\/p>\n<p>\u0627\u06cc\u062c\u0646\u0679 \u06a9\u06d2 \u0645\u0648\u0627\u0641\u0642 OpenAPI \u06a9\u06d2 \u0644\u06cc\u06d2 \u06a9\u0645 \u0627\u0632 \u06a9\u0645 \u0645\u0639\u06cc\u0627\u0631 \u06cc\u06c1 \u06c1\u06cc\u06ba:<\/p>\n<ul>\n<li>\n<p>\u062a\u0645\u0627\u0645 \u06a9\u0627\u0645\u0648\u06ba \u06a9\u06d2 \u0644\u06cc\u06d2 <code>summary<\/code> \u0627\u0648\u0631 <code>description<\/code> \u0648\u0636\u0627\u062d\u062a <em>\u062c\u0628<\/em> \u0646\u06c1 \u0635\u0631\u0641 \u0622\u067e \u0627\u0633\u06d2 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4 <em>\u06a9\u06cc\u0627<\/em> \u06cc\u06c1 \u0648\u0627\u067e\u0633 \u0622\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<\/li>\n<li>\n<p>\u062a\u0645\u0627\u0645 \u062f\u0631\u062e\u0648\u0627\u0633\u062a \u062c\u0633\u0645 \u06a9\u06cc \u062e\u0635\u0648\u0635\u06cc\u0627\u062a \u0645\u06cc\u06ba \u0634\u0627\u0645\u0644 \u06c1\u06cc\u06ba <code>description<\/code> \u0627\u0648\u0631 \u06cc\u06c1 \u062d\u0642\u06cc\u0642\u062a \u067e\u0633\u0646\u062f\u0627\u0646\u06c1 \u06c1\u06d2\u06d4 <code>example<\/code> \u0642\u062f\u0631<\/p>\n<\/li>\n<li>\n<p>\u062a\u0645\u0627\u0645 \u062c\u0648\u0627\u0628\u0627\u062a \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u06cc \u06c1\u06cc\u06ba\u060c \u0628\u0634\u0645\u0648\u0644 \u0645\u0633\u062a\u062d\u06a9\u0645 JSON \u0641\u0627\u0631\u0645\u06cc\u0679 \u0645\u06cc\u06ba 4xx\/5xx\u06d4<\/p>\n<\/li>\n<\/ul>\n<h3 id=\"heading-describe-intent-in-natural-language-precisely\">\u0641\u0637\u0631\u06cc \u0632\u0628\u0627\u0646 \u0645\u06cc\u06ba \u0627\u0631\u0627\u062f\u06d2 \u06a9\u0648 \u062f\u0631\u0633\u062a \u0637\u0631\u06cc\u0642\u06d2 \u0633\u06d2 \u0628\u06cc\u0627\u0646 \u06a9\u0631\u06cc\u06ba\u06d4<\/h3>\n<p>\u0627\u06cc\u062c\u0646\u0679 \u0644\u0641\u0638\u0648\u06ba \u0633\u06d2 \u0646\u0627\u0631\u0627\u0636 \u0646\u06c1\u06cc\u06ba \u06c1\u0648\u062a\u06d2\u06d4 \u0648\u06c1 \u0645\u0628\u06c1\u0645 \u0641\u0639\u0644 \u0633\u06d2 \u0627\u0644\u062c\u06be \u062c\u0627\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/p>\n<p>\u0628\u062c\u0627\u0626\u06d2:<\/p>\n<blockquote>\n<p>\u2019\u2019\u0645\u06cc\u06ba \u062d\u06a9\u0645 \u0644\u06cc\u062a\u0627 \u06c1\u0648\u06ba\u06d4\u2018\u2018<\/p>\n<\/blockquote>\n<p>\u062a\u0631\u062c\u06cc\u062d \u062f\u06cc\u06ba:<\/p>\n<blockquote>\n<p>&quot;\u062a\u0635\u062f\u06cc\u0642 \u0634\u062f\u06c1 \u0641\u0631\u0648\u062e\u062a \u06a9\u0646\u0646\u062f\u06af\u0627\u0646 \u06a9\u06d2 \u0622\u0631\u0688\u0631\u0632 \u06a9\u06cc \u0641\u06c1\u0631\u0633\u062a\u06d4 \u0641\u0644\u0679\u0631\u0646\u06af \u06a9\u06cc \u062d\u0645\u0627\u06cc\u062a \u06a9\u0631\u062a\u0627 \u06c1\u06d2\u06d4 <code>status<\/code> \u0627\u0648\u0631 \u0679\u0627\u0626\u0645 \u0648\u0646\u0688\u0648 \u06c1\u06d2\u06d4 <code>created_at<\/code>. \u0632\u06cc\u0627\u062f\u06c1 \u0633\u06d2 \u0632\u06cc\u0627\u062f\u06c1 \u0648\u0627\u067e\u0633\u06cc <code>limit<\/code> \u0622\u0626\u0679\u0645 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u06cc\u06ba <code>cursor<\/code> \u0627\u06af\u0644\u06d2 \u0635\u0641\u062d\u06d2 \u06a9\u06d2 \u0644\u06cc\u06d2\u06d4&#8221;<\/p>\n<\/blockquote>\n<p>\u06cc\u06c1 \u0627\u0633 \u0633\u06d2 \u0645\u0637\u0627\u0628\u0642\u062a \u0631\u06a9\u06be\u062a\u0627 \u06c1\u06d2 \u062c\u0633\u06d2 \u0645\u062a\u0639\u062f\u062f \u0631\u06c1\u0646\u0645\u0627 \u06a9\u06c1\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4 <strong>\u062d\u0627\u0644\u0627\u062a \u0633\u06d2 \u0645\u062a\u0639\u0644\u0642 \u0622\u06af\u0627\u06c1\u06cc<\/strong> \u06cc\u0627 <strong>\u062e\u0648\u062f \u0648\u0636\u0627\u062d\u062a\u06cc<\/strong> API: \u0627\u0633\u06a9\u06cc\u0645\u0627\u0633 \u0646\u06c1 \u0635\u0631\u0641 \u0627\u0642\u0633\u0627\u0645 \u0628\u0644\u06a9\u06c1 \u0645\u0639\u0646\u0648\u06cc \u0627\u0631\u0627\u062f\u06d2 \u06a9\u0648 \u0628\u06be\u06cc \u067e\u06c1\u0646\u0686\u0627\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/p>\n<h3 id=\"heading-examples-are-part-of-the-contract\">\u0645\u062b\u0627\u0644 \u0645\u0639\u0627\u06c1\u062f\u06d2 \u06a9\u0627 \u062d\u0635\u06c1 \u06c1\u06d2\u06d4<\/h3>\n<p>\u0622\u067e \u06a9\u0648 \u0641\u06cc \u0627\u062e\u062a\u062a\u0627\u0645\u06cc \u0646\u0642\u0637\u06c1 \u06a9\u06d2 \u0633\u0627\u062a\u06be \u0627\u06cc\u06a9 \u0645\u062b\u0627\u0644 \u06c1\u06cc\u067e\u06cc \u067e\u0627\u062a\u06be\u060c \u0645\u0639\u06cc\u0627\u0631\u06cc \u0627\u06cc\u0631\u0631 \u0622\u0628\u062c\u06cc\u06a9\u0679 \u06a9\u06d2 \u0633\u0627\u062a\u06be \u06a9\u0645 \u0627\u0632 \u06a9\u0645 \u0627\u06cc\u06a9 \u0645\u062b\u0627\u0644 \u06a9\u06cc \u062a\u0648\u062b\u06cc\u0642 \u06a9\u06cc \u063a\u0644\u0637\u06cc (400)\u060c \u0627\u0648\u0631 \u0631\u0648\u06cc\u06d2 \u06a9\u0648 \u062a\u0628\u062f\u06cc\u0644 \u06a9\u0631\u062a\u06d2 \u0648\u0642\u062a \u0627\u062e\u062a\u06cc\u0627\u0631\u06cc \u0641\u06cc\u0644\u0688\u0632 \u06a9\u06cc \u0645\u062b\u0627\u0644 \u0641\u0631\u0627\u06c1\u0645 \u06a9\u0631\u0646\u06cc \u0686\u0627\u06c1\u06cc\u06d2\u06d4<\/p>\n<p>\u0627\u0633 \u0633\u06d2 &#8216;\u0634\u06a9\u0644 \u06a9\u0627 \u0648\u06c1\u0645&#8217; \u06a9\u0645 \u06c1\u0648 \u062c\u0627\u062a\u0627 \u06c1\u06d2\u060c \u062c\u06c1\u0627\u06ba \u0645\u0627\u0688\u0644 \u0641\u06cc\u0644\u0688 \u06a9\u06d2 \u0646\u0627\u0645\u0648\u06ba \u06cc\u0627 \u0627\u0648\u0648\u0631\u0644\u06cc\u067e \u06a9\u0627 \u0627\u0646\u062f\u0627\u0632\u06c1 \u0644\u06af\u0627\u062a\u0627 \u06c1\u06d2\u060c \u0645\u062b\u0627\u0644 \u06a9\u06d2 \u0637\u0648\u0631 \u067e\u0631\u06d4<\/p>\n<h3 id=\"heading-json-schema-strictness-helps-tool-calling-stacks\">JSON \u0627\u0633\u06a9\u06cc\u0645\u0627 \u0633\u062e\u062a\u06cc \u0679\u0648\u0644 \u06a9\u0627\u0644 \u0627\u0633\u0679\u06cc\u06a9 \u06a9\u0648 \u0633\u067e\u0648\u0631\u0679 \u06a9\u0631\u062a\u06cc \u06c1\u06d2\u06d4<\/h3>\n<p>\u0627\u06af\u0631 \u0622\u067e \u06a9\u0627 \u0627\u06cc\u062c\u0646\u0679 \u0641\u0646\u06a9\u0634\u0646 \u06a9\u0627\u0644\u0632\/\u0633\u0679\u0631\u06a9\u0686\u0631\u0688 \u0622\u0624\u0679 \u067e\u0679 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u062a\u0627 \u06c1\u06d2 \u062a\u0648 \u0627\u067e\u0646\u06d2 \u0627\u0633\u06a9\u06cc\u0645\u0627 \u06a9\u0648 \u0633\u062e\u062a \u06a9\u0631\u06cc\u06ba\u06d4<\/p>\n<ul>\n<li>\n<p>\u062a\u0631\u062c\u06cc\u062d \u062f\u06cc\u062a\u06d2 \u06c1\u06cc\u06ba <code>enum<\/code> \u0686\u06be\u0648\u0679\u06d2 \u0628\u0646\u062f \u0633\u06cc\u0679\u0648\u06ba \u06a9\u06d2 \u0644\u06cc\u06d2\u06d4<\/p>\n<\/li>\n<li>\n<p>\u0641\u06cc\u0644\u0688 \u0688\u0633\u067e\u0644\u06d2 <code>required<\/code> \u0627\u06cc\u0645\u0627\u0646\u062f\u0627\u0631 \u06c1\u0648\u0646\u0627<\/p>\n<\/li>\n<li>\n<p>\u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u06cc\u06ba <code>format<\/code> (<code>uuid<\/code>\u060c <code>date-time<\/code>) \u062c\u06c1\u0627\u06ba \u06cc\u06c1 \u062d\u0642\u06cc\u0642\u06cc \u06c1\u06d2\u06d4<\/p>\n<\/li>\n<li>\n<p>\u0628\u0686\u0646\u0627 <code>additionalProperties: true<\/code> \u0633\u06cc\u06a9\u0648\u0631\u0679\u06cc \u06a9\u06d2 \u0644\u062d\u0627\u0638 \u0633\u06d2 \u062d\u0633\u0627\u0633 \u067e\u06d2 \u0644\u0648\u0688\u0632 \u06a9\u06d2 \u0644\u06cc\u06d2 \u062c\u06c1\u0627\u06ba \u0633\u062e\u062a \u062a\u0635\u062f\u06cc\u0642 \u06a9\u06cc \u0636\u0631\u0648\u0631\u062a \u06c1\u06d2\u06d4<\/p>\n<\/li>\n<\/ul>\n<h3 id=\"heading-name-things-consistently\">\u0686\u06cc\u0632\u0648\u06ba \u06a9\u0648 \u0645\u0633\u062a\u0642\u0644 \u0637\u0648\u0631 \u067e\u0631 \u0646\u0627\u0645 \u062f\u06cc\u06ba\u06d4<\/h3>\n<p><code>userId<\/code>    \u0627\u06cc\u06a9 \u0627\u062e\u062a\u062a\u0627\u0645\u06cc \u0646\u0642\u0637\u06c1 \u0633\u06d2 <code>user_id<\/code> \u062f\u0648\u0633\u0631\u0627 \u0627\u0646\u0633\u0627\u0646\u06cc \u062c\u06be\u0646\u062c\u06be\u0644\u0627\u06c1\u0679 \u0627\u0648\u0631 \u0627\u06cc\u062c\u0646\u0679 \u06a9\u0627 \u062c\u0627\u0644 \u06c1\u06d2\u06d4 \u0627\u067e\u0646\u06d2 \u0642\u0648\u0627\u0646\u06cc\u0646 \u06a9\u0627 \u0627\u0646\u062a\u062e\u0627\u0628 \u06a9\u0631\u06cc\u06ba \u0627\u0648\u0631 \u0627\u0646\u06c1\u06cc\u06ba \u0646\u0627\u0641\u0630 \u06a9\u0631\u06cc\u06ba\u06d4<\/p>\n<h2 id=\"heading-principle-3-guardrails-at-the-api-boundary\">\u0627\u0635\u0648\u0644 3: API \u062d\u062f\u0648\u062f \u06a9\u06d2 \u0627\u0631\u062f \u06af\u0631\u062f \u06af\u0627\u0631\u0688\u0631\u06cc\u0644\u0632<\/h2>\n<p>\u062e\u0648\u062f \u0645\u062e\u062a\u0627\u0631\u06cc \u063a\u0644\u0637\u06cc\u0648\u06ba \u06a9\u0648 \u0628\u0691\u06be\u0627\u062a\u06cc \u06c1\u06d2\u06d4 \u06af\u0627\u0631\u0688\u0631\u06cc\u0644\u0632 \u062d\u0627\u062f\u062b\u0627\u062a \u06a9\u06cc \u0628\u062c\u0627\u0626\u06d2 &quot;\u0627\u0641\u0648\u06c1&#8221; \u06a9\u0648 \u0645\u0633\u062f\u0648\u062f \u062f\u0631\u062e\u0648\u0627\u0633\u062a\u0648\u06ba \u0645\u06cc\u06ba \u0628\u062f\u0644 \u062f\u06cc\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/p>\n<h3 id=\"heading-authorization-should-be-narrow-and-explicit\">\u0627\u062e\u062a\u06cc\u0627\u0631\u0627\u062a \u06a9\u06cc \u06af\u0631\u0627\u0646\u0679\u0633 \u062a\u0646\u06af \u0627\u0648\u0631 \u0648\u0627\u0636\u062d \u06c1\u0648\u0646\u06cc \u0686\u0627\u06c1\u0626\u06cc\u06ba\u06d4<\/h3>\n<p>\u0627\u06cc\u062c\u0646\u0679\u0648\u06ba \u06a9\u06d2 \u067e\u0627\u0633 \u062f\u0631\u062c \u0630\u06cc\u0644 \u0627\u0633\u0646\u0627\u062f \u06a9\u0627 \u06c1\u0648\u0646\u0627 \u0636\u0631\u0648\u0631\u06cc \u06c1\u06d2: <strong>\u06a9\u0645 \u0627\u0632 \u06a9\u0645 \u0627\u0633\u062a\u062d\u0642\u0627\u0642<\/strong>. \u0645\u062b\u0627\u0644 \u06a9\u06d2 \u0637\u0648\u0631 \u067e\u0631\u060c \u0648\u0627\u0636\u062d \u0637\u0648\u0631 \u067e\u0631 \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u06cc \u062a\u0627\u0632\u06c1 \u06a9\u0627\u0631\u06cc \u06a9\u06d2 \u0633\u0627\u062a\u06be \u0645\u062e\u062a\u0635\u0631 \u0645\u062f\u062a \u06a9\u06d2 \u0679\u0648\u06a9\u0646 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u06cc\u06ba\u06d4 \u0627\u06cc\u06a9 \u0631\u06cc\u0646\u062c \u06a9\u0627 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u06cc\u06ba \u062c\u0648 \u0627\u0635\u0644 \u06a9\u0627\u0645 \u06a9\u0627 \u0646\u0642\u0634\u06c1 \u0628\u0646\u0627\u062a\u0627 \u06c1\u06d2 (<code>orders:read<\/code> \u0628\u0691\u0627 <code>orders:write<\/code>)\u06d4 \u0627\u0648\u0631 \u0627\u06cc\u0633\u06d2 \u0628\u06c1\u0627\u0624 \u0633\u06d2 \u0628\u0686\u06cc\u06ba \u062c\u0648 \u0641\u0631\u0636 \u06a9\u0631\u06cc\u06ba \u06a9\u06c1 \u06a9\u0648\u0626\u06cc \u0627\u0646\u0633\u0627\u0646 \u0627\u0633\u06d2 \u062d\u0644 \u06a9\u0631 \u0633\u06a9\u062a\u0627 \u06c1\u06d2 (CAPTCHA) \u06cc\u0627 \u0627\u0633 \u067e\u0631 \u06a9\u0644\u06a9 \u06a9\u0631 \u0633\u06a9\u062a\u0627 \u06c1\u06d2 (\u062f\u0631\u0645\u06cc\u0627\u0646 \u0645\u06cc\u06ba \u0627\u06cc \u0645\u06cc\u0644 \u0644\u0646\u06a9)\u060c \u06cc\u0627 \u06cc\u06c1 \u06a9\u06c1 \u0622\u067e \u0627\u0633\u06d2 \u0627\u0646\u0633\u0627\u0646\u06cc \u0645\u0635\u0631\u0648\u0641\u06cc\u062a \u0648\u0627\u0644\u06d2 \u0679\u0648\u0644 \u0633\u06d2 \u0627\u0644\u06af \u06a9\u0631 \u0633\u06a9\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/p>\n<h3 id=\"heading-validate-hard-fail-loud-and-structured\">\u0633\u062e\u062a\u060c \u0641\u06cc\u0644 \u0644\u0627\u0624\u0688\u060c \u0633\u0679\u0631\u06a9\u0686\u0631\u0688 \u062a\u0635\u062f\u06cc\u0642<\/h3>\n<p>\u06a9\u0646\u0627\u0631\u06d2 \u067e\u0631 \u062e\u0631\u0627\u0628 \u0627\u0646 \u067e\u0679 \u06a9\u0648 \u0645\u0633\u062a\u0631\u062f \u06a9\u0631\u0646\u06d2 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0645\u0633\u062a\u062d\u06a9\u0645 \u06a9\u0627 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u06cc\u06ba\u06d4 <code>error_code<\/code> \u0642\u062f\u0631 (\u0645\u0634\u06cc\u0646 \u06a9\u06d2 \u0630\u0631\u06cc\u0639\u06d2 \u0642\u0627\u0628\u0644 \u0639\u0645\u0644)\u060c \u0627\u0646\u0633\u0627\u0646\u06cc \u067e\u0691\u06be\u0646\u06d2 \u06a9\u06d2 \u0642\u0627\u0628\u0644 <code>message<\/code> (\u0644\u0627\u06af\u0632 \u0627\u0648\u0631 UI \u06a9\u06d2 \u0644\u06cc\u06d2)\u060c \u0627\u062e\u062a\u06cc\u0627\u0631\u06cc <code>field<\/code> \u06cc\u0627 JSON \u067e\u0648\u0627\u0626\u0646\u0679\u0631 \u0627\u0648\u0631 \u0622\u067e \u06a9\u06d2 \u0645\u0633\u0626\u0644\u06d2 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0622\u067e \u06a9\u06d2 \u0627\u0646\u062a\u062e\u0627\u0628 <code>doc_url<\/code> \u062f\u0633\u062a\u0627\u0648\u06cc\u0632 \u0633\u06d2 \u0644\u0646\u06a9 \u06a9\u0631\u06cc\u06ba\u06d4<\/p>\n<p>\u06cc\u06c1 \u0645\u062a\u0639\u062f\u062f \u067e\u0631\u06cc\u06a9\u0679\u06cc\u0634\u0646\u0631 \u0645\u0636\u0627\u0645\u06cc\u0646 \u0633\u06d2 \u0631\u06c1\u0646\u0645\u0627\u0626\u06cc \u06a9\u06d2 \u0645\u0637\u0627\u0628\u0642 \u06c1\u06d2\u06d4 \u0645\u0628\u06c1\u0645 500s \u0627\u0648\u0631 \u0639\u0627\u0645 \u063a\u0644\u0637\u06cc\u0627\u06ba \u0648\u06c1 \u06c1\u06cc\u06ba \u062c\u06c1\u0627\u06ba \u062e\u0648\u062f \u0645\u062e\u062a\u0627\u0631 \u06a9\u0644\u0627\u0626\u0646\u0679\u0633 \u0633\u0631\u067e\u0644 \u06c1\u0648\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/p>\n<p>RFC 7807 \u0645\u0633\u0626\u0644\u06c1 \u06a9\u06cc \u062a\u0641\u0635\u06cc\u0644\u0627\u062a (<code>application\/problem+json<\/code>) HTTP APIs \u06a9\u06d2 \u0644\u06cc\u06d2 \u0627\u06cc\u06a9 \u0627\u0686\u06be\u0627 \u0627\u0648\u0631 \u0648\u0633\u06cc\u0639 \u067e\u06cc\u0645\u0627\u0646\u06d2 \u067e\u0631 \u0633\u0645\u062c\u06be\u0627 \u062c\u0627\u0646\u06d2 \u0648\u0627\u0644\u0627 \u067e\u06cc\u0679\u0631\u0646 \u06c1\u06d2\u060c \u0627\u0648\u0631 \u0633\u0679\u0631\u06a9\u0686\u0631\u0688 \u0644\u0641\u0627\u0641\u06d2 \u06a9\u06d2 \u0627\u06cc\u062c\u0646\u0679 \u0627\u0633\u06d2 \u0645\u0633\u062a\u0642\u0644 \u0637\u0648\u0631 \u067e\u0631 \u067e\u0627\u0631\u0633 \u06a9\u0631 \u0633\u06a9\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/p>\n<h3 id=\"heading-separate-read-the-world-from-change-the-world\">&#8216;\u062f\u0646\u06cc\u0627 \u06a9\u0648 \u062a\u0628\u062f\u06cc\u0644 \u06a9\u0631\u06cc\u06ba&#8217; \u0633\u06d2 &#8216;\u062f\u0646\u06cc\u0627 \u06a9\u0648 \u067e\u0691\u06be\u06cc\u06ba&#8217; \u06a9\u0648 \u0627\u0644\u06af \u06a9\u0631\u06cc\u06ba\u06d4<\/h3>\n<p>\u0632\u06cc\u0627\u062f\u06c1 \u0627\u062b\u0631 \u0627\u0646\u062f\u0627\u0632 \u06c1\u0648\u0646\u06d2 \u0648\u0627\u0644\u06d2 \u0622\u067e\u0631\u06cc\u0634\u0646\u0632 (\u0631\u06cc\u0641\u0646\u0688\u060c \u0688\u06cc\u0644\u06cc\u0679\u060c \u0679\u0631\u0627\u0646\u0633\u0641\u0631) \u06a9\u06d2 \u0644\u06cc\u06d2\u060c \u06c1\u0645 \u062f\u0648 \u0642\u062f\u0645\u06cc \u067e\u06cc\u0679\u0631\u0646 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631\u0646\u06d2 \u06a9\u06cc \u062a\u062c\u0648\u06cc\u0632 \u06a9\u0631\u062a\u06d2 \u06c1\u06cc\u06ba \u062c\u06c1\u0627\u06ba \u0622\u067e \u067e\u06c1\u0644\u06d2 \u0627\u06cc\u06a9 \u0627\u0631\u0627\u062f\u06c1 \u0628\u0646\u0627\u062a\u06d2 \u06c1\u06cc\u06ba \u0627\u0648\u0631 \u067e\u06be\u0631 \u0627\u0633 \u067e\u0631 \u0639\u0645\u0644 \u062f\u0631\u0622\u0645\u062f \u06a9\u06cc \u062a\u0635\u062f\u06cc\u0642 \u06a9\u0631\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/p>\n<p>\u0645\u062a\u0628\u0627\u062f\u0644 \u06a9\u06d2 \u0637\u0648\u0631 \u067e\u0631\u060c \u0622\u067e \u0627\u06cc\u06a9 \u0679\u06cc\u0633\u0679 \u0631\u0646 \u0627\u0633\u062a\u0641\u0633\u0627\u0631 \u067e\u06cc\u0631\u0627\u0645\u06cc\u0679\u0631\/\u0688\u06cc\u0688\u06cc\u06a9\u06cc\u0679\u0688 \u0627\u06cc\u0646\u0688 \u067e\u0648\u0627\u0626\u0646\u0679 \u0627\u0633\u062a\u0639\u0645\u0627\u0644 \u06a9\u0631 \u0633\u06a9\u062a\u06d2 \u06c1\u06cc\u06ba \u062c\u0648 \u0628\u063a\u06cc\u0631 \u0627\u0631\u062a\u06a9\u0627\u0628 \u06a9\u06d2 \u062a\u0648\u062b\u06cc\u0642 \u06a9\u0631\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<p>\u0627\u0633 \u0628\u0627\u062a \u06a9\u0648 \u0628\u06be\u06cc \u0630\u06c1\u0646 \u0645\u06cc\u06ba \u0631\u06a9\u06be\u06cc\u06ba \u06a9\u06c1 \u0631\u06cc\u0679 \u06a9\u06cc \u062d\u062f\u06cc\u06ba \u0627\u0648\u0631 \u06a9\u0648\u0679\u06c1 \u0628\u0631\u0633\u0679\u06cc \u0627\u06cc\u062c\u0646\u0679 \u06a9\u06d2 \u0631\u0648\u06cc\u06d2 \u0627\u0648\u0631 \u062e\u0648\u062f \u0645\u062e\u062a\u0627\u0631 \u0644\u0648\u067e\u0633 \u06a9\u06d2 \u0645\u0637\u0627\u0628\u0642 \u0627\u0646\u0633\u0627\u0646\u06cc \u0679\u0631\u06cc\u0641\u06a9 \u06a9\u06cc \u062d\u0648\u0635\u0644\u06c1 \u0634\u06a9\u0646\u06cc \u06a9\u0631 \u0633\u06a9\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/p>\n<h3 id=\"heading-observability-is-a-product-feature\">\u0645\u0634\u0627\u06c1\u062f\u06c1 \u0627\u06cc\u06a9 \u0645\u0635\u0646\u0648\u0639\u0627\u062a \u06a9\u06cc \u062e\u0635\u0648\u0635\u06cc\u062a \u06c1\u06d2\u06d4<\/h3>\n<p>\u0627\u0631\u062a\u0628\u0627\u0637\u06cc IDs \u06a9\u0648 \u0631\u06cc\u06a9\u0627\u0631\u0688 \u06a9\u0631\u06cc\u06ba\u060c \u0627\u0646\u06c1\u06cc\u06ba \u0645\u062d\u0641\u0648\u0638 \u062c\u0648\u0627\u0628\u0627\u062a \u0645\u06cc\u06ba \u0646\u0634\u0627\u0646 \u0632\u062f \u06a9\u0631\u06cc\u06ba\u060c \u0627\u0648\u0631 \u062f\u0648\u0628\u0627\u0631\u06c1 \u06a9\u0648\u0634\u0634 \u06a9\u0631\u0646\u06d2 \u06a9\u06cc \u0646\u06af\u0631\u0627\u0646\u06cc \u06a9\u0631\u06cc\u06ba\u06d4 \u0627\u06cc\u06a9 \u0627\u06cc\u062c\u0646\u0679 409 \u06a9\u0648 &quot;\u0645\u0633\u062a\u0642\u0644 \u062f\u0648\u0628\u0627\u0631\u06c1 \u06a9\u0648\u0634\u0634&#8221; \u06a9\u06d2 \u0637\u0648\u0631 \u067e\u0631 \u063a\u0644\u0637 \u067e\u0691\u06be\u062a\u0627 \u06c1\u06d2 \u062c\u0633 \u06a9\u06d2 \u0646\u062a\u06cc\u062c\u06d2 \u0645\u06cc\u06ba \u0633\u0633\u0679\u0645 \u06a9\u06d2 \u062e\u0644\u0627\u0641 \u067e\u0631\u0633 \u06a9\u06d2 \u062d\u0645\u0644\u06d2 \u0633\u06d2 \u0627\u0646\u06a9\u0627\u0631 \u06c1\u0648\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<h2 id=\"heading-patterns-that-bridge-apis-and-agent-runtimes\">\u067e\u06cc\u0679\u0631\u0646 \u062c\u0648 APIs \u0627\u0648\u0631 \u0627\u06cc\u062c\u0646\u0679 \u0631\u0646 \u0679\u0627\u0626\u0645\u0632 \u06a9\u0648 \u062c\u0648\u0691\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/h2>\n<h3 id=\"heading-workflow-documentation-sequences-not-just-endpoints\">\u0648\u0631\u06a9 \u0641\u0644\u0648 \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u06cc: \u062a\u0633\u0644\u0633\u0644\u060c \u0646\u06c1 \u0635\u0631\u0641 \u0627\u062e\u062a\u062a\u0627\u0645\u06cc \u0646\u0642\u0637\u06c1<\/h3>\n<p>\u0627\u06cc\u062c\u0646\u0679 \u0627\u0633 \u0648\u0642\u062a \u0628\u06c1\u062a\u0631 \u06c1\u0648\u062a\u06d2 \u06c1\u06cc\u06ba \u062c\u0628 \u0648\u06c1 \u06a9\u0633\u06cc \u062a\u0631\u06a9\u06cc\u0628 \u067e\u0631 \u0639\u0645\u0644 \u06a9\u0631 \u0633\u06a9\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4 \u0639\u0627\u0645 \u062a\u0631\u062a\u06cc\u0628 \u06a9\u0648 \u062f\u0633\u062a\u0627\u0648\u06cc\u0632 \u06a9\u0631\u06cc\u06ba (&quot;\u06a9\u0633\u0679\u0645\u0631 \u0628\u0646\u0627\u0626\u06cc\u06ba \u2192 \u0627\u062f\u0627\u0626\u06cc\u06af\u06cc \u06a9\u0627 \u0637\u0631\u06cc\u0642\u06c1 \u0634\u0627\u0645\u0644 \u06a9\u0631\u06cc\u06ba \u2192 \u0628\u0644&#8221;) \u0627\u0648\u0631 \u0627\u06af\u0631 \u0622\u067e \u06a9\u06d2 \u067e\u0631\u0648\u0688\u06a9\u0679 \u06a9\u06cc \u067e\u06cc\u0686\u06cc\u062f\u06af\u06cc \u0627\u0633 \u06a9\u0627 \u062c\u0648\u0627\u0632 \u067e\u06cc\u0634 \u06a9\u0631\u062a\u06cc \u06c1\u06d2 \u062a\u0648 \u0645\u0644\u0679\u06cc \u0633\u0679\u06cc\u067e API \u0641\u0644\u0648\u0632 (\u062c\u06cc\u0633\u06d2 Arazzo) \u06a9\u06d2 \u0645\u0639\u06cc\u0627\u0631\u0627\u062a \u067e\u0631 \u063a\u0648\u0631 \u06a9\u0631\u06cc\u06ba\u06d4<\/p>\n<h3 id=\"heading-hypermedia-and-next-steps\">\u06c1\u0627\u0626\u067e\u0631 \u0645\u06cc\u0688\u06cc\u0627 \u0627\u0648\u0631 &quot;\u0627\u06af\u0644\u0627 \u0642\u062f\u0645&#8221;<\/h3>\n<p>\u0645\u0645\u06a9\u0646\u06c1 \u0627\u06af\u0644\u06cc \u06a9\u0627\u0631\u0631\u0648\u0627\u0626\u06cc\u0648\u06ba \u06a9\u06d2 \u0644\u0646\u06a9\u0633 \u0634\u0627\u0645\u0644 \u06a9\u0631\u06cc\u06ba (\u062c\u06cc\u0633\u06d2 \u0635\u0641\u062d\u06c1 \u0628\u0646\u062f\u06cc) <code>next<\/code>\u06cc\u0627 \u0645\u062a\u0639\u0644\u0642\u06c1 \u0648\u0633\u0627\u0626\u0644) \u0628\u06c1\u062a\u0631\u06cc \u06a9\u0648 \u06a9\u0645 \u06a9\u0631\u06cc\u06ba\u06d4 \u06cc\u06c1 \u0648\u06c1\u06cc \u062c\u0630\u0628\u06c1 \u06c1\u06d2 \u062c\u0648 HATEOAS \u06c1\u06d2\u06d4 \u062c\u0648\u0627\u0628 \u0633\u0631\u06af\u0648\u0634\u06cc \u06a9\u0631\u062a\u0627 \u06c1\u06d2 \u06a9\u06c1 \u0645\u0627\u0688\u0644 \u06a9\u0648 URL \u06a9\u0627 \u0627\u0646\u062f\u0627\u0632\u06c1 \u0644\u06af\u0627\u0646\u06d2 \u067e\u0631 \u0645\u062c\u0628\u0648\u0631 \u06a9\u0631\u0646\u06d2 \u06a9\u06d2 \u0628\u062c\u0627\u0626\u06d2 \u0648\u06c1 \u0622\u06af\u06d2 \u06a9\u06cc\u0627 \u06a9\u0631 \u0633\u06a9\u062a\u0627 \u06c1\u06d2\u06d4<\/p>\n<h3 id=\"heading-tool-oriented-surfaces-for-example-mcp\">\u0679\u0648\u0644 \u0633\u06cc\u0646\u0679\u0631\u0688 \u0633\u0637\u062d (\u062c\u06cc\u0633\u06d2 MCP)<\/h3>\n<p>\u067e\u0631\u0648\u0679\u0648\u06a9\u0648\u0644 \u062c\u06cc\u0633\u06d2 \u0645\u0627\u0688\u0644 \u0633\u06cc\u0627\u0642 \u0648 \u0633\u0628\u0627\u0642 \u067e\u0631\u0648\u0679\u0648\u06a9\u0648\u0644 (MCP) \u0627\u06cc\u06a9 \u0627\u0633\u06a9\u06cc\u0645\u0627 \u06a9\u06d2 \u0630\u0631\u06cc\u0639\u06d2 \u06a9\u06cc\u0648\u0631\u06cc\u0679\u0688 \u0641\u0646\u06a9\u0634\u0646\u0644\u0679\u06cc (&quot;\u0679\u0648\u0644\u0632&#8221;) \u06a9\u0648 \u0628\u06d2 \u0646\u0642\u0627\u0628 \u06a9\u0631\u0646\u06d2 \u06a9\u06d2 \u0637\u0631\u06cc\u0642\u06d2 \u06a9\u06d2 \u0637\u0648\u0631 \u067e\u0631 \u062a\u0648\u062c\u06c1 \u062d\u0627\u0635\u0644 \u06a9\u0631 \u0631\u06c1\u06d2 \u06c1\u06cc\u06ba \u062c\u0633 \u0633\u06d2 \u0627\u06cc\u062c\u0646\u0679 \u0628\u0631\u0627\u06c1 \u0631\u0627\u0633\u062a \u067e\u0627\u0628\u0646\u062f \u06c1\u0648 \u0633\u06a9\u062a\u06d2 \u06c1\u06cc\u06ba\u06d4<\/p>\n<p>\u0627\u06cc\u06a9 \u0639\u0627\u0645 \u0639\u0645\u0644\u06cc \u0646\u0645\u0648\u0646\u06c1 \u062a\u0645\u0627\u0645 \u0645\u0627\u0626\u06cc\u06a9\u0631\u0648 \u0627\u06cc\u0646\u0688 \u067e\u0648\u0627\u0626\u0646\u0679\u0633 \u06a9\u0648 \u0679\u0648\u0644\u0632 \u06a9\u06d2 \u0637\u0648\u0631 \u067e\u0631 \u067e\u06be\u06cc\u0646\u06a9\u0646\u0627 \u0646\u06c1\u06cc\u06ba \u06c1\u06d2\u060c \u0628\u0644\u06a9\u06c1 \u0628\u0646\u06cc\u0627\u062f\u06cc REST API \u06a9\u0648 \u0633\u062e\u062a \u0627\u0648\u0631 \u0635\u0627\u0641 \u0631\u06a9\u06be\u062a\u06d2 \u06c1\u0648\u0626\u06d2 \u0635\u0627\u0631\u0641 \u06a9\u06d2 \u0646\u062a\u0627\u0626\u062c \u06a9\u06d2 \u0645\u0637\u0627\u0628\u0642 \u0628\u0646\u0627\u0626\u06d2 \u06af\u0626\u06d2 \u0645\u0648\u0679\u06d2 \u062f\u0627\u0646\u06d2 \u0648\u0627\u0644\u06d2 \u0679\u0648\u0644\u0632 \u06a9\u0648 \u0628\u06d2 \u0646\u0642\u0627\u0628 \u06a9\u0631\u0646\u0627 \u06c1\u06d2\u06d4<\/p>\n<p>MCP \u0627\u0686\u06be\u06d2 API \u0688\u06cc\u0632\u0627\u0626\u0646 \u06a9\u0627 \u0645\u062a\u0628\u0627\u062f\u0644 \u0646\u06c1\u06cc\u06ba \u06c1\u06d2\u06d4 \u0641\u0627\u0631\u0648\u0631\u0688\u0646\u06af \u0627\u0648\u0631 \u0628\u0627\u0632\u06cc\u0627\u0641\u062a \u067e\u0631\u062a\u06d4 \u06af\u0646\u062f\u06d2 API \u067e\u0631 \u0627\u06cc\u06a9 \u067e\u062a\u0644\u06cc \u0686\u0627\u062f\u0631 \u0688\u0627\u0644\u0646\u0627 \u0627\u0628 \u0628\u06be\u06cc \u0622\u067e \u06a9\u0648 \u06af\u0646\u062f\u0627 \u0646\u0638\u0627\u0645 \u0686\u06be\u0648\u0691 \u062f\u06cc\u062a\u0627 \u06c1\u06d2\u06d4 \u0639\u0648\u0627\u0645\u06cc \u06c1\u0648\u0646\u0627 \u0635\u0631\u0641 \u0622\u067e \u06a9\u0648 \u062a\u06cc\u0632\u06cc \u0633\u06d2 \u0646\u0627\u06a9\u0627\u0645 \u06c1\u0648\u0646\u06d2 \u06a9\u0627 \u0633\u0628\u0628 \u0628\u0646\u06d2 \u06af\u0627\u06d4<\/p>\n<h3 id=\"heading-metadata-for-discovery-llmstxt-and-friends\">\u062a\u0644\u0627\u0634 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0645\u06cc\u0679\u0627 \u0688\u06cc\u0679\u0627 (<code>llms.txt<\/code> \u0627\u0648\u0631 \u062f\u0648\u0633\u062a)<\/h3>\n<p>\u06a9\u0686\u06be \u0679\u06cc\u0645\u06cc\u06ba \u067e\u0648\u0633\u0679 \u06a9\u0631\u062a\u06cc \u06c1\u06cc\u06ba\u06d4 <code>\/llms.txt<\/code> \u06cc\u0627 \u0622\u0631\u0679\u06cc\u06a9\u0644 \u0633\u0627\u0626\u0679\u0633 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0627\u0633\u06cc \u0637\u0631\u062d \u06a9\u06cc \u06c1\u0644\u06a9\u06cc \u067e\u06be\u0644\u06a9\u06cc \u0633\u0631\u0686 \u0641\u0627\u0626\u0644\u06d4 \u0627\u0633\u06d2 \u0627\u06cc\u06a9 \u0627\u062e\u062a\u06cc\u0627\u0631\u06cc \u0646\u0634\u0627\u0646\u06cc \u06a9\u06d2 \u0637\u0648\u0631 \u067e\u0631 \u0633\u0645\u062c\u06be\u06cc\u06ba\u060c \u0646\u06c1 \u06a9\u06c1 OpenAPI \u06a9\u0627 \u0645\u062a\u0628\u0627\u062f\u0644\u06d4<\/p>\n<p>\u0645\u0627\u062d\u0648\u0644\u06cc\u0627\u062a\u06cc \u0646\u0638\u0627\u0645 \u06a9\u0648 \u0627\u067e\u0646\u0627\u0646\u0627 \u0627\u0628 \u0628\u06be\u06cc \u062a\u06cc\u0627\u0631 \u06c1\u0648 \u0631\u06c1\u0627 \u06c1\u06d2\u060c \u0644\u06cc\u06a9\u0646 \u0628\u0646\u06cc\u0627\u062f\u06cc \u062e\u06cc\u0627\u0644 \u062f\u0631\u0633\u062a \u06c1\u06d2\u06d4 \u0645\u0642\u0635\u062f \u06cc\u06c1 \u06c1\u06d2 \u06a9\u06c1 \u0645\u0639\u06cc\u0627\u0631\u06cc\u060c \u0645\u0634\u06cc\u0646 \u0633\u06d2 \u067e\u0691\u06be\u0646\u06d2 \u06a9\u06d2 \u0642\u0627\u0628\u0644 \u0648\u0636\u0627\u062d\u062a\u06cc\u06ba \u062a\u0644\u0627\u0634 \u06a9\u0631\u0646\u0627 \u0622\u0633\u0627\u0646 \u06c1\u0648\u06d4<\/p>\n<h2 id=\"heading-a-practical-beforeafter\">\u067e\u06c1\u0644\u06d2\/\u0628\u0639\u062f \u0645\u06cc\u06ba \u0639\u0645\u0644\u06cc<\/h2>\n<h3 id=\"heading-weak-pattern-agent-hostile\">\u06a9\u0645\u0632\u0648\u0631 \u067e\u06cc\u0679\u0631\u0646 (\u0627\u06cc\u062c\u0646\u0679 \u0645\u062e\u0627\u0644\u0641)<\/h3>\n<pre><code class=\"language-http\">POST \/do-stuff\n<\/code><\/pre>\n<p>\u062c\u0648\u0627\u0628 <code>200 OK<\/code>:<\/p>\n<pre><code class=\"language-json\">{ \"ok\": true }\n<\/code><\/pre>\n<p>\u0645\u0633\u0627\u0626\u0644: \u06a9\u0648\u0626\u06cc \u0622\u0626\u06cc\u0688\u06cc\u0645\u067e\u0648\u0679\u06cc\u0646\u0633\u06cc \u0646\u06c1\u06cc\u06ba\u060c \u06a9\u0648\u0626\u06cc \u0633\u0627\u062e\u062a\u06cc \u062e\u0627\u0645\u06cc\u0627\u06ba \u0646\u06c1\u06cc\u06ba\u060c \u06a9\u0648\u0626\u06cc \u06c1\u0633\u062a\u06cc IDs \u0646\u06c1\u06cc\u06ba\u060c \u067e\u0648\u0644\u0646\u06af \u06a9\u0627 \u06a9\u0648\u0626\u06cc \u0637\u0631\u06cc\u0642\u06c1 \u0646\u06c1\u06cc\u06ba\u060c \u0627\u06cc\u062c\u0646\u0679 \u06a9\u0648 \u0627\u0646\u062f\u0627\u0632\u06c1 \u0644\u06af\u0627\u0646\u0627 \u06c1\u0648\u06af\u0627 \u06a9\u06c1 &quot;\u0627\u0648\u06a9\u06d2&#8221; \u06a9\u0627 \u0645\u0637\u0644\u0628 \u06c1\u06d2 &quot;\u062a\u062e\u0644\u06cc\u0642 \u0634\u062f\u06c1&#8221; \u06cc\u0627 &quot;\u0688\u067e\u0644\u06cc\u06a9\u06cc\u0679 \u0646\u0638\u0631 \u0627\u0646\u062f\u0627\u0632&#8221;\u06d4<\/p>\n<h3 id=\"heading-stronger-pattern-agent-friendly\">\u0632\u06cc\u0627\u062f\u06c1 \u0637\u0627\u0642\u062a\u0648\u0631 \u067e\u06cc\u0679\u0631\u0646 (\u0627\u06cc\u062c\u0646\u0679 \u062f\u0648\u0633\u062a\u0627\u0646\u06c1)<\/h3>\n<pre><code class=\"language-http\">POST \/v1\/invoices\nIdempotency-Key: 7b3c-...\n<\/code><\/pre>\n<p>\u062c\u0648\u0627\u0628 <code>201 Created<\/code>:<\/p>\n<pre><code class=\"language-json\">{\n  \"invoice\": {\n    \"id\": \"inv_9Qz\",\n    \"status\": \"draft\",\n    \"total\": { \"amount\": \"120.00\", \"currency\": \"USD\" }\n  },\n  \"links\": {\n    \"finalize\": \"\/v1\/invoices\/inv_9Qz\/finalize\"\n  }\n}\n<\/code><\/pre>\n<p>\u062a\u0646\u0627\u0632\u0639\u06c1 \u06a9\u0627 \u062c\u0648\u0627\u0628 <code>409 Conflict<\/code> \u0645\u0633\u0626\u0644\u06c1 \u06a9\u06cc \u062a\u0641\u0635\u06cc\u0644\u0627\u062a \u067e\u0631 \u0645\u0634\u062a\u0645\u0644 \u06c1\u06d2:<\/p>\n<pre><code class=\"language-json\">{\n  \"type\": \"https:\/\/api.example.com\/problems\/duplicate-idempotency-key\",\n  \"title\": \"Duplicate idempotency key\",\n  \"status\": 409,\n  \"detail\": \"A different request body was sent with the same Idempotency-Key.\",\n  \"error_code\": \"IDEMPOTENCY_KEY_REUSE_BODY_MISMATCH\"\n}\n<\/code><\/pre>\n<p>\u06cc\u06c1 \u0627\u06cc\u062c\u0646\u0679 \u06a9\u0648 \u0628\u062a\u0627\u062a\u0627 \u06c1\u06d2 \u06a9\u06c1 \u06a9\u06cc\u0627 \u06c1\u0648\u0627 \u0627\u0648\u0631 \u06a9\u06cc\u0627 \u062f\u0648\u0628\u0627\u0631\u06c1 \u06a9\u0648\u0634\u0634 \u06a9\u0631\u0646\u0627 \u0645\u0646\u0627\u0633\u0628 \u06c1\u06d2\u06d4<\/p>\n<h2 id=\"heading-checklist-is-your-api-agent-ready\">\u0686\u06cc\u06a9 \u0644\u0633\u0679: \u06a9\u06cc\u0627 \u0622\u067e \u06a9\u0627 API \u0627\u06cc\u062c\u0646\u0679 \u062a\u06cc\u0627\u0631 \u06c1\u06d2\u061f<\/h2>\n<ul>\n<li>\n<p><strong>\u0645\u0639\u0627\u06c1\u062f\u06c1<\/strong>: OpenAPI 3.x \u0634\u0627\u0626\u0639 \u06a9\u06cc\u0627 \u06af\u06cc\u0627 \u06c1\u06d2\u060c \u062d\u0642\u06cc\u0642\u06cc \u0679\u0631\u06cc\u0641\u06a9 \u06a9\u06d2 \u062e\u0644\u0627\u0641 \u062a\u0635\u062f\u06cc\u0642 \u0634\u062f\u06c1\u060c \u067e\u0631\u0686\u0631 \u0648\u0636\u0627\u062d\u062a\u0648\u06ba \u0627\u0648\u0631 \u0645\u062b\u0627\u0644\u0648\u06ba \u06a9\u06d2 \u0633\u0627\u062a\u06be\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u0639\u0632\u0645<\/strong>: \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u06cc \u0631\u06cc\u0627\u0633\u062a\u06cc \u0645\u0634\u06cc\u0646\u06cc\u06ba\u060c \u0645\u0633\u0644\u0633\u0644 \u0635\u0641\u062d\u06c1 \u0628\u0646\u062f\u06cc\u060c \u0637\u0648\u06cc\u0644 \u0622\u067e\u0631\u06cc\u0634\u0646\u0632 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0648\u0627\u0636\u062d async\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u0645\u062d\u0641\u0648\u0638 \u062a\u062d\u0631\u06cc\u0631<\/strong>: \u0636\u0645\u0646\u06cc \u0627\u062b\u0631\u0627\u062a \u06a9\u06d2 \u0644\u06cc\u06d2 \u0642\u0627\u0628\u0644\u06cc\u062a\u060c \u0627\u06af\u0631 \u0636\u0631\u0648\u0631\u06cc \u06c1\u0648 \u062a\u0648 \u0627\u062e\u062a\u062a\u0627\u0645\u06cc \u0646\u06a9\u0627\u062a \u06a9\u0648 \u0627\u06cc\u0688\u062c\u0633\u0679 \u06a9\u0631\u06cc\u06ba\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u063a\u0644\u0637\u06cc<\/strong>: \u0645\u0633\u062a\u062d\u06a9\u0645 \u06a9\u0648\u0688\u060c \u062a\u0634\u06a9\u06cc\u0644 \u0634\u062f\u06c1 \u0628\u0627\u0688\u06cc\u060c \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u06cc \u0627\u0635\u0644\u0627\u062d\u06cc \u0631\u0627\u0633\u062a\u06c1\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u0633\u06cc\u06a9\u0648\u0631\u0679\u06cc<\/strong>: \u06a9\u0645 \u0633\u06d2 \u06a9\u0645 \u0627\u0633\u062a\u062d\u0642\u0627\u0642 \u06a9\u0627 \u0679\u0648\u06a9\u0646\u060c &quot;\u0627\u0633\u0631\u0627\u0631&#8221; \u0633\u0627\u0626\u06cc\u0688 \u0688\u0648\u0631 \u0627\u06cc\u062c\u0646\u0679 \u063a\u0644\u0637\u06cc \u0633\u06d2 \u062d\u0645\u0644\u06c1 \u0646\u06c1\u06cc\u06ba \u06a9\u0631 \u0633\u06a9\u062a\u0627\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u06a9\u0627\u0645<\/strong>: \u0634\u0631\u062d \u06a9\u0648 \u0645\u062d\u062f\u0648\u062f \u06a9\u0631\u0646\u06d2 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0688\u06cc\u0634 \u0628\u0648\u0631\u0688\u0632\u060c \u062c\u06c1\u0627\u06ba \u0645\u0646\u0627\u0633\u0628 \u06c1\u0648 \u0628\u0644\u06a9 \u0627\u06cc\u0646\u0688 \u067e\u0648\u0627\u0626\u0646\u0679\u0633\u060c \u0627\u0631\u062a\u0628\u0627\u0637\u06cc IDs\u060c \u0627\u0648\u0631 \u063a\u06cc\u0631 \u0645\u0639\u0645\u0648\u0644\u06cc \u0627\u06cc\u062c\u0646\u0679 \u0679\u0631\u06cc\u0641\u06a9\u06d4<\/p>\n<\/li>\n<\/ul>\n<h2 id=\"heading-conclusion\">\u0646\u062a\u06cc\u062c\u06c1<\/h2>\n<p>AI \u0627\u06cc\u062c\u0646\u0679 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0688\u06cc\u0632\u0627\u0626\u0646 \u06a9\u0631\u0646\u0627\u060c \u0632\u06cc\u0627\u062f\u06c1 \u062a\u0631 \u0645\u0639\u0627\u0645\u0644\u0627\u062a \u0645\u06cc\u06ba\u060c \u0645\u0646\u0638\u0645 API \u0688\u06cc\u0632\u0627\u0626\u0646 \u06c1\u06d2\u06d4 \u0627\u0633 \u06a9\u0627 \u0645\u0637\u0644\u0628 \u06cc\u06c1 \u06c1\u06d2 \u06a9\u06c1 \u0645\u0634\u06cc\u0646\u0648\u06ba \u06a9\u0648 \u0627\u0633 \u0645\u0642\u0627\u0645 \u067e\u0631 \u062f\u06be\u06a9\u06cc\u0644 \u062f\u06cc\u0627 \u062c\u0627\u062a\u0627 \u06c1\u06d2 \u062c\u06c1\u0627\u06ba \u0648\u06c1 \u0628\u063a\u06cc\u0631 \u06a9\u0633\u06cc \u0639\u0644\u0645 \u06a9\u06cc \u06a9\u0645\u06cc \u06a9\u06d2 \u0645\u0639\u0627\u06c1\u062f\u0648\u06ba \u067e\u0631 \u0627\u0646\u062d\u0635\u0627\u0631 \u06a9\u0631 \u0633\u06a9\u062a\u06cc \u06c1\u06cc\u06ba\u06d4<\/p>\n<p>\u0627\u06af\u0631 \u0622\u067e \u06a9\u0648 \u0635\u0631\u0641 \u062a\u06cc\u0646 \u0686\u06cc\u0632\u06cc\u06ba \u06cc\u0627\u062f \u06c1\u06cc\u06ba\u06d4<\/p>\n<ol>\n<li>\n<p><strong>\u0642\u0627\u0628\u0644 \u0642\u06cc\u0627\u0633:<\/strong> \u0638\u0627\u06c1\u0631\u06cc \u0634\u06a9\u0644\u060c \u062d\u0627\u0644\u062a \u0627\u0648\u0631 \u0636\u0645\u0646\u06cc \u0627\u062b\u0631\u0627\u062a\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u0648\u0627\u0636\u062d \u0637\u0648\u0631 \u067e\u0631:<\/strong> \u0627\u0633\u06a9\u06cc\u0645\u0627\u060c \u0645\u062b\u0627\u0644\u06cc\u06ba\u060c \u0627\u0648\u0631 \u063a\u0644\u0637\u06cc\u0627\u06ba\u06d4<\/p>\n<\/li>\n<li>\n<p><strong>\u062d\u0641\u0627\u0638\u062a:<\/strong> \u062c\u0644\u062f \u06a9\u0648\u0627\u0644\u06cc\u0641\u0627\u0626\u06cc \u06a9\u0631\u06cc\u06ba\u060c \u062f\u0627\u0626\u0631\u06c1 \u06a9\u0627\u0631 \u06a9\u0648 \u06a9\u0645 \u06a9\u0631\u06cc\u06ba\u060c \u0627\u0648\u0631 \u062d\u0627\u062f\u062b\u0627\u062a\u06cc \u0637\u0648\u0631 \u067e\u0631 \u062e\u0637\u0631\u0646\u0627\u06a9 \u0631\u0648\u06cc\u06d2 \u06a9\u0648 \u0645\u062a\u062d\u0631\u06a9 \u06a9\u0631\u0646\u0627 \u0645\u0634\u06a9\u0644 \u0628\u0646\u0627\u0626\u06cc\u06ba\u06d4<\/p>\n<\/li>\n<\/ol><\/div>\n","protected":false},"excerpt":{"rendered":"<p>API \u06a9\u0648 \u0627\u0646\u0633\u0627\u0646\u06cc \u0688\u0648\u06cc\u0644\u067e\u0631\u0632 \u06a9\u06d2 \u0644\u06cc\u06d2 \u0688\u06cc\u0632\u0627\u0626\u0646 \u06a9\u06cc\u0627 \u06af\u06cc\u0627 \u06c1\u06d2\u06d4 \u0644\u0648\u06af \u062c\u0627\u0646\u062a\u06d2 \u06c1\u06cc\u06ba \u06a9\u06c1 \u062f\u0633\u062a\u0627\u0648\u06cc\u0632\u0627\u062a \u06a9\u0648 \u06a9\u06cc\u0633\u06d2 \u067e\u0691\u06be\u0646\u0627 \u06c1\u06d2\u060c \u0627\u062e\u062a\u062a\u0627\u0645\u06cc \u0646\u0642\u0637\u0648\u06ba \u06a9\u06d2 \u067e\u06cc\u0686\u06be\u06d2 \u06a9\u06cc \u0646\u06cc\u062a \u06a9\u0627 \u0627\u0646\u062f\u0627\u0632\u06c1 \u0644\u06af\u0627\u0646\u0627 \u06c1\u06d2\u060c \u0627\u0648\u0631 \u062c\u0628 \u06a9\u0648\u0626\u06cc \u063a\u06cc\u0631 \u0645\u062a\u0648\u0642\u0639 \u0648\u0627\u0642\u0639\u06c1 \u067e\u06cc\u0634 \u0622\u062a\u0627 \u06c1\u06d2 \u062a\u0648 \u06a9\u0646\u0627\u0631\u06d2 \u06a9\u06d2 \u0645\u0639\u0627\u0645\u0644\u0627\u062a \u06a9\u0648 \u06c1\u06cc\u0646\u0688\u0644 \u06a9\u0631\u0646\u0627 \u06c1\u06d2\u06d4 AI \u0627\u06cc\u062c\u0646\u0679\u0648\u06ba \u06a9\u06d2 \u067e\u0627\u0633 \u0648\u06c1 \u0633\u06cc\u0627\u0642 \u0648 \u0633\u0628\u0627\u0642 \u0627\u0648\u0631 [&hellip;]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[1],"tags":[],"class_list":["post-24618","post","type-post","status-publish","format-standard","hentry","category-blog"],"_links":{"self":[{"href":"https:\/\/umang.pk\/ur\/wp-json\/wp\/v2\/posts\/24618","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/umang.pk\/ur\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/umang.pk\/ur\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/umang.pk\/ur\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/umang.pk\/ur\/wp-json\/wp\/v2\/comments?post=24618"}],"version-history":[{"count":0,"href":"https:\/\/umang.pk\/ur\/wp-json\/wp\/v2\/posts\/24618\/revisions"}],"wp:attachment":[{"href":"https:\/\/umang.pk\/ur\/wp-json\/wp\/v2\/media?parent=24618"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/umang.pk\/ur\/wp-json\/wp\/v2\/categories?post=24618"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/umang.pk\/ur\/wp-json\/wp\/v2\/tags?post=24618"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}