অনলাইনে JSON Schemaকনভার্টারOpenAPI
বিভিন্ন স্ট্যান্ডার্ডের মধ্যে আপনার ডেটা মডেলগুলিকে স্থানান্তর করা একটি ক্লান্তিকর ম্যানুয়াল কাজ হতে পারে। আমাদের JSON Schemaটু OpenAPIকনভার্টারJSON Schema এই প্রক্রিয়াটিকে স্বয়ংক্রিয় করে তোলে, যা আপনাকে তাৎক্ষণিকভাবে স্ট্যান্ডার্ড সংজ্ঞাগুলিকে OpenAPIস্পেসিফিকেশন(OAS) সামঞ্জস্যপূর্ণ ফর্ম্যাটে রূপান্তর করতে দেয় । আপনি Swagger ডকুমেন্টেশন তৈরি করছেন বা অনুরোধ/প্রতিক্রিয়া সংস্থাগুলি সংজ্ঞায়িত করছেন, এই টুলটি নির্ভুলতা এবং সম্মতি নিশ্চিত করে।
কেন রূপান্তর JSON Schemaকরবেন OpenAPI?
যদিও OpenAPI(পূর্বে Swagger) এর একটি উপসেট ব্যবহার করে, বিভিন্ন সংস্করণ(খসড়া 4, 7, অথবা 2019-09) এবং 3.0/3.1 স্পেসিফিকেশনের মধ্যে, , এবং এর মতো নির্দিষ্ট কীওয়ার্ডগুলি কীভাবে পরিচালনা করা হয় তার JSON Schemaমধ্যে গুরুত্বপূর্ণ পার্থক্য রয়েছে ।typenullableformatOpenAPI
সামঞ্জস্যের ব্যবধান পূরণ করা
OpenAPI৩.০-এর কিছু নির্দিষ্ট সীমাবদ্ধতা রয়েছে যা স্ট্যান্ডার্ড থেকে আলাদা JSON Schema। আমাদের কনভার্টার এই সূক্ষ্মতাগুলি পরিচালনা করে, যেমন dependenciesসামঞ্জস্যপূর্ণ লজিকে রূপান্তর করা বা অ্যারেগুলিকে এর কঠোর প্রয়োজনীয়তা typeপূরণের জন্য সামঞ্জস্য করা, যাতে আপনার API ডকুমেন্টেশন বৈধ থাকে।OpenAPI
API ডেভেলপমেন্ট স্ট্রিমলাইন করুন
আপনার API ডকুমেন্টের জন্য আপনার ডাটাবেস মডেল বা বৈধতা স্কিমা পুনর্লিখনের পরিবর্তে, আপনি কেবল আপনার বিদ্যমান JSON Schema. পেস্ট করতে পারেন। এটি মানব ত্রুটি হ্রাস করে এবং আপনার ব্যাকএন্ড লজিক এবং ডকুমেন্টেশনকে পুরোপুরি সিঙ্কে রাখে।
আমাদের কনভার্টারের মূল বৈশিষ্ট্য
আমাদের টুলটি এমন ডেভেলপারদের জন্য ডিজাইন করা হয়েছে যাদের API স্পেসিফিকেশন পরিচালনা করার সময় নির্ভুলতা এবং গতির প্রয়োজন।
JSON Schema1. একাধিক খসড়ার জন্য সমর্থন
আপনার সোর্স স্কিমা ড্রাফ্ট ৪, ৭, অথবা ২০২০-১২ এর উপর ভিত্তি করে হোক না কেন, আমাদের ইঞ্জিন কাঠামোটি সনাক্ত করে এবং নিকটতম OpenAPIসমতুল্যের সাথে ম্যাপ করে।
২. OpenAPI৩.০ এবং ৩.১ প্রস্তুত
OpenAPI৩.১ এখন JSON Schema২০১৯-০৯ এর সাথে সম্পূর্ণ সামঞ্জস্যপূর্ণ। তবে, যদি আপনি এখনও ৩.০ ব্যবহার করেন, তাহলে আমাদের টুলটি সামঞ্জস্য বজায় রাখার জন্য নির্দিষ্ট ক্ষেত্রগুলিকে(যেমন এর পরিবর্তে) OpenAPIস্বয়ংক্রিয়ভাবে "ডাউনগ্রেড" করবে ।nullable: truetype: ["string", "null"]
৩. তাৎক্ষণিক বৈধতা এবং বিন্যাসকরণ
এটি কেবল ডেটা রূপান্তর করে না, বরং আউটপুটকেও সুন্দর করে তোলে। আপনি একটি পরিষ্কার, ইন্ডেন্টেড এবং বৈধ OpenAPIস্কিমা পাবেন যা আপনার components/schemasবিভাগে পেস্ট করার জন্য প্রস্তুত।
কনভার্টারটি কীভাবে ব্যবহার করবেন
আপনার কোড পেস্ট করুন:JSON Schema ইনপুট এডিটরে আপনার সোর্স কপি করুন ।
সংস্করণ নির্বাচন করুন(ঐচ্ছিক): আপনি আউটপুটটি OpenAPI3.0 বা নতুন 3.1 স্ট্যান্ডার্ডের জন্য অপ্টিমাইজ করতে চান তা চয়ন করুন।
কনভার্টে ক্লিক করুন: টুলটি লজিক প্রক্রিয়া করবে এবং আউটপুট উইন্ডোতে OpenAPI-সম্মত ফলাফল প্রদর্শন করবে।
কপি এবং ব্যবহার: আপনার Swagger বা Redocly ডকুমেন্টেশনের জন্য আপনার নতুন স্কিমা পেতে "কপি" বোতামটি ব্যবহার করুন।
প্রযুক্তিগত পার্থক্যগুলির দিকে নজর রাখা উচিত
"Nullable" সম্পত্তি পরিচালনা করা
স্ট্যান্ডার্ডে JSON Schema, একটি nullable ক্ষেত্র প্রায়শই হিসাবে সংজ্ঞায়িত করা হয় । 3.0type: ["string", "null"] এ, এটিকে একটি পৃথক বৈশিষ্ট্যের সাথে রূপান্তর করতে হবে । আমাদের রূপান্তরকারী এটি স্বয়ংক্রিয়ভাবে পরিচালনা করে।OpenAPItype: stringnullable: true
"ফর্ম্যাট" কীওয়ার্ড
OpenAPIযাচাইকরণের জন্য কীওয়ার্ডটি আরও ব্যাপকভাবে ব্যবহার করে format(যেমন, int32, int64, float, double)। আমাদের টুল নিশ্চিত করে যে রূপান্তরের সময় এই ফর্ম্যাটগুলি সঠিকভাবে সংরক্ষিত এবং ম্যাপ করা হয়েছে।
প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী(FAQ)
এই কনভার্টারটি কি Swagger 2.0 এর সাথে সামঞ্জস্যপূর্ণ?
যদিও ফোকাস OpenAPI3.x-এর উপর, জেনারেট করা স্কিমাগুলি মূলত Swagger 2.0-এর সাথে সামঞ্জস্যপূর্ণ, যদিও definitionsবিভাগটির জন্য কিছু সমন্বয় প্রয়োজন হতে পারে।
আমার ডেটা কি আমার ব্রাউজার থেকে চলে যায়?
না। সমস্ত রূপান্তর লজিক জাভাস্ক্রিপ্ট ব্যবহার করে আপনার ব্রাউজারে স্থানীয়ভাবে ঘটে। আপনার সংবেদনশীল API স্কিমাগুলি কখনই আমাদের সার্ভারে পাঠানো হয় না।
আমি কি বড়, জটিল স্কিমা রূপান্তর করতে পারি?
হ্যাঁ। আমাদের টুলটি পারফরম্যান্স ল্যাগ ছাড়াই গভীরভাবে নেস্টেড স্কিমা এবং বৃহৎ অবজেক্ট সংজ্ঞা পরিচালনা করার জন্য অপ্টিমাইজ করা হয়েছে।