કન્વર્ટર JSON Schemaમાટે ઓનલાઈનOpenAPI
તમારા ડેટા મોડેલ્સને વિવિધ ધોરણો વચ્ચે સ્થાનાંતરિત કરવું એક કંટાળાજનક મેન્યુઅલ કાર્ય હોઈ શકે છે. અમારું JSON Schemaટુ OpenAPIકન્વર્ટરJSON Schema આ પ્રક્રિયાને સ્વચાલિત કરે છે, જેનાથી તમે પ્રમાણભૂત વ્યાખ્યાઓને તરત જ OpenAPIસ્પષ્ટીકરણ(OAS) સુસંગત ફોર્મેટમાં રૂપાંતરિત કરી શકો છો. ભલે તમે સ્વેગર દસ્તાવેજીકરણ બનાવી રહ્યા હોવ અથવા વિનંતી/પ્રતિભાવ સંસ્થાઓને વ્યાખ્યાયિત કરી રહ્યા હોવ, આ સાધન ચોકસાઈ અને પાલનની ખાતરી કરે છે.
JSON Schemaમાં કન્વર્ટ કેમ કરવું OpenAPI?
જ્યારે OpenAPI(અગાઉનું સ્વેગર) ના સબસેટનો ઉપયોગ કરે છે, ત્યારે વિવિધ સંસ્કરણો(ડ્રાફ્ટ 4, 7, અથવા 2019-09) અને 3.0/3.1 સ્પષ્ટીકરણો વચ્ચે, , અને JSON Schemaજેવા ચોક્કસ કીવર્ડ્સને કેવી રીતે હેન્ડલ કરવામાં આવે છે તેમાં મહત્વપૂર્ણ તફાવત છે .typenullableformatOpenAPI
સુસંગતતા ગેપને દૂર કરવું
OpenAPI3.0 માં ચોક્કસ મર્યાદાઓ છે જે ધોરણથી અલગ છે JSON Schema. અમારું કન્વર્ટર આ ઘોંઘાટને સંભાળે છે, જેમ કે dependenciesસુસંગત તર્કમાં રૂપાંતરિત કરવું અથવા કડક આવશ્યકતાઓને typeપૂર્ણ કરવા માટે એરેને સમાયોજિત કરવું, ખાતરી કરવી કે તમારું API દસ્તાવેજીકરણ માન્ય રહે.OpenAPI
API વિકાસને સુવ્યવસ્થિત કરો
તમારા API દસ્તાવેજો માટે તમારા ડેટાબેઝ મોડેલ્સ અથવા માન્યતા સ્કીમાને ફરીથી લખવાને બદલે, તમે ફક્ત તમારા હાલના પેસ્ટ કરી શકો છો JSON Schema. આ માનવ ભૂલ ઘટાડે છે અને તમારા બેકએન્ડ લોજિક અને દસ્તાવેજીકરણને સંપૂર્ણ રીતે સુમેળમાં રાખે છે.
અમારા કન્વર્ટરની મુખ્ય વિશેષતાઓ
અમારું ટૂલ એવા ડેવલપર્સ માટે રચાયેલ છે જેમને API સ્પષ્ટીકરણોનું સંચાલન કરતી વખતે ચોકસાઈ અને ગતિની જરૂર હોય છે.
JSON Schema1. બહુવિધ ડ્રાફ્ટ્સ માટે સપોર્ટ
ભલે તમારી સોર્સ સ્કીમા ડ્રાફ્ટ 4, 7, અથવા 2020-12 પર આધારિત હોય, અમારું એન્જિન સ્ટ્રક્ચરને ઓળખે છે અને તેને નજીકના OpenAPIસમકક્ષ સાથે મેપ કરે છે.
૨. OpenAPI૩.૦ અને ૩.૧ તૈયાર
OpenAPI૩.૧ હવે JSON Schema૨૦૧૯-૦૯ સાથે સંપૂર્ણપણે સુસંગત છે. જો કે, જો તમે હજુ પણ ૩.૦ નો ઉપયોગ કરી રહ્યા છો, તો અમારું ટૂલ સુસંગતતા જાળવવા માટે OpenAPIચોક્કસ ક્ષેત્રોને આપમેળે "ડાઉનગ્રેડ" કરશે(જેમ કે nullable: trueને બદલે).type: ["string", "null"]
3. ત્વરિત માન્યતા અને ફોર્મેટિંગ
તે ફક્ત ડેટાને કન્વર્ટ જ નથી કરતું, પરંતુ આઉટપુટને પણ સુંદર બનાવે છે. તમને એક સ્વચ્છ, ઇન્ડેન્ટેડ અને માન્ય OpenAPIસ્કીમા મળે છે જે તમારા વિભાગમાં પેસ્ટ કરવા માટે તૈયાર છે components/schemas.
કન્વર્ટરનો ઉપયોગ કેવી રીતે કરવો
તમારો કોડ પેસ્ટ કરો: તમારા સ્રોતને JSON Schemaઇનપુટ એડિટરમાં કોપી કરો.
સંસ્કરણ પસંદ કરો(વૈકલ્પિક): તમે આઉટપુટને OpenAPI3.0 માટે ઑપ્ટિમાઇઝ કરવા માંગો છો કે નવા 3.1 સ્ટાન્ડર્ડ માટે.
કન્વર્ટ પર ક્લિક કરો: આ ટૂલ લોજિક પર પ્રક્રિયા કરશે અને આઉટપુટ વિન્ડોમાં OpenAPI-સુસંગત પરિણામ પ્રદર્શિત કરશે.
નકલ કરો અને ઉપયોગ કરો: તમારા સ્વેગર અથવા રેડોક્લી દસ્તાવેજો માટે તમારી નવી સ્કીમા મેળવવા માટે "કૉપિ કરો" બટનનો ઉપયોગ કરો.
ટેકનિકલ તફાવતો પર ધ્યાન આપવું
"નલેબલ" પ્રોપર્ટીનું સંચાલન
સ્ટાન્ડર્ડમાં JSON Schema, નલેબલ ફીલ્ડને ઘણીવાર .3.0type: ["string", "null"] માં, આને એક અલગ પ્રોપર્ટી સાથે રૂપાંતરિત કરવું આવશ્યક છે. અમારું કન્વર્ટર આને આપમેળે હેન્ડલ કરે છે.OpenAPItype: stringnullable: true
"ફોર્મેટ" કીવર્ડ
OpenAPIમાન્યતા માટે કીવર્ડનો વધુ વ્યાપક ઉપયોગ થાય છે format(દા.ત., int32, int64, float, double). અમારું ટૂલ ખાતરી કરે છે કે રૂપાંતર દરમિયાન આ ફોર્મેટ યોગ્ય રીતે સાચવવામાં આવે અને મેપ કરવામાં આવે.
વારંવાર પૂછાતા પ્રશ્નો(FAQ)
શું આ કન્વર્ટર સ્વેગર 2.0 સાથે સુસંગત છે?
જ્યારે ધ્યાન OpenAPI3.x પર છે, ત્યારે જનરેટ થયેલ સ્કીમા મોટાભાગે સ્વેગર 2.0 સાથે સુસંગત છે, જોકે definitionsવિભાગ માટે કેટલાક ગોઠવણોની જરૂર પડી શકે છે.
શું મારો ડેટા મારા બ્રાઉઝરમાંથી નીકળી જાય છે?
ના. બધા રૂપાંતર તર્ક તમારા બ્રાઉઝરમાં જાવાસ્ક્રિપ્ટનો ઉપયોગ કરીને સ્થાનિક રીતે થાય છે. તમારા સંવેદનશીલ API સ્કીમા ક્યારેય અમારા સર્વર પર મોકલવામાં આવતા નથી.
શું હું મોટા, જટિલ સ્કીમા કન્વર્ટ કરી શકું?
હા. અમારું ટૂલ પર્ફોર્મન્સ લેગ વિના ઊંડાણપૂર્વક નેસ્ટેડ સ્કીમા અને મોટા ઑબ્જેક્ટ વ્યાખ્યાઓને હેન્ડલ કરવા માટે ઑપ્ટિમાઇઝ કરેલ છે.