ਔਨਲਾਈਨ ਕਨਵਰਟਰ JSON SchemaਲਈOpenAPI
ਆਪਣੇ ਡੇਟਾ ਮਾਡਲਾਂ ਨੂੰ ਵੱਖ-ਵੱਖ ਮਿਆਰਾਂ ਵਿਚਕਾਰ ਮਾਈਗ੍ਰੇਟ ਕਰਨਾ ਇੱਕ ਔਖਾ ਹੱਥੀਂ ਕੰਮ ਹੋ ਸਕਦਾ ਹੈ। ਸਾਡਾ JSON Schemaਟੂ OpenAPIਕਨਵਰਟਰ ਇਸ ਪ੍ਰਕਿਰਿਆ ਨੂੰ ਸਵੈਚਾਲਿਤ ਕਰਦਾ ਹੈ, ਜਿਸ ਨਾਲ ਤੁਸੀਂ ਸਟੈਂਡਰਡ ਪਰਿਭਾਸ਼ਾਵਾਂ ਨੂੰ ਤੁਰੰਤ ਸਪੈਸੀਫਿਕੇਸ਼ਨ(OAS)JSON Schema ਅਨੁਕੂਲ ਫਾਰਮੈਟਾਂ ਵਿੱਚ ਬਦਲ ਸਕਦੇ ਹੋ । ਭਾਵੇਂ ਤੁਸੀਂ ਸਵੈਗਰ ਦਸਤਾਵੇਜ਼ ਬਣਾ ਰਹੇ ਹੋ ਜਾਂ ਬੇਨਤੀ/ਜਵਾਬ ਸੰਸਥਾਵਾਂ ਨੂੰ ਪਰਿਭਾਸ਼ਿਤ ਕਰ ਰਹੇ ਹੋ, ਇਹ ਟੂਲ ਸ਼ੁੱਧਤਾ ਅਤੇ ਪਾਲਣਾ ਨੂੰ ਯਕੀਨੀ ਬਣਾਉਂਦਾ ਹੈ।OpenAPI
JSON Schemaਵਿੱਚ ਕਿਉਂ ਬਦਲੋ OpenAPI?
ਜਦੋਂ ਕਿ OpenAPI(ਪਹਿਲਾਂ ਸਵੈਗਰ) ਦੇ ਇੱਕ ਸਬਸੈੱਟ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ, ਵੱਖ-ਵੱਖ ਸੰਸਕਰਣਾਂ(ਡਰਾਫਟ 4, 7, ਜਾਂ 2019-09) ਅਤੇ 3.0/3.1 ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਵਿਚਕਾਰ, , ਅਤੇ JSON Schemaਵਰਗੇ ਕੁਝ ਕੀਵਰਡਸ ਨੂੰ ਕਿਵੇਂ ਸੰਭਾਲਿਆ ਜਾਂਦਾ ਹੈ, ਇਸ ਵਿੱਚ ਮਹੱਤਵਪੂਰਨ ਅੰਤਰ ਹਨ ।typenullableformatOpenAPI
ਅਨੁਕੂਲਤਾ ਪਾੜੇ ਨੂੰ ਪੂਰਾ ਕਰਨਾ
OpenAPI3.0 ਵਿੱਚ ਖਾਸ ਪਾਬੰਦੀਆਂ ਹਨ ਜੋ ਸਟੈਂਡਰਡ ਤੋਂ ਵੱਖਰੀਆਂ ਹਨ JSON Schema। ਸਾਡਾ ਕਨਵਰਟਰ ਇਹਨਾਂ ਸੂਖਮਤਾਵਾਂ ਨੂੰ ਸੰਭਾਲਦਾ ਹੈ, ਜਿਵੇਂ ਕਿ dependenciesਅਨੁਕੂਲ ਤਰਕ ਵਿੱਚ ਬਦਲਣਾ ਜਾਂ typeਐਰੇ ਨੂੰ OpenAPIਇਸਦੀਆਂ ਸਖ਼ਤ ਜ਼ਰੂਰਤਾਂ ਨੂੰ ਪੂਰਾ ਕਰਨ ਲਈ ਐਡਜਸਟ ਕਰਨਾ, ਇਹ ਯਕੀਨੀ ਬਣਾਉਣਾ ਕਿ ਤੁਹਾਡਾ API ਦਸਤਾਵੇਜ਼ ਵੈਧ ਰਹੇ।
API ਵਿਕਾਸ ਨੂੰ ਸੁਚਾਰੂ ਬਣਾਓ
ਆਪਣੇ API ਦਸਤਾਵੇਜ਼ਾਂ ਲਈ ਆਪਣੇ ਡੇਟਾਬੇਸ ਮਾਡਲਾਂ ਜਾਂ ਪ੍ਰਮਾਣਿਕਤਾ ਸਕੀਮਾਂ ਨੂੰ ਦੁਬਾਰਾ ਲਿਖਣ ਦੀ ਬਜਾਏ, ਤੁਸੀਂ ਸਿਰਫ਼ ਆਪਣੇ ਮੌਜੂਦਾ ਨੂੰ ਪੇਸਟ ਕਰ ਸਕਦੇ ਹੋ JSON Schema। ਇਹ ਮਨੁੱਖੀ ਗਲਤੀ ਨੂੰ ਘਟਾਉਂਦਾ ਹੈ ਅਤੇ ਤੁਹਾਡੇ ਬੈਕਐਂਡ ਤਰਕ ਅਤੇ ਦਸਤਾਵੇਜ਼ਾਂ ਨੂੰ ਪੂਰੀ ਤਰ੍ਹਾਂ ਸਮਕਾਲੀ ਰੱਖਦਾ ਹੈ।
ਸਾਡੇ ਕਨਵਰਟਰ ਦੀਆਂ ਮੁੱਖ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ
ਸਾਡਾ ਟੂਲ ਉਹਨਾਂ ਡਿਵੈਲਪਰਾਂ ਲਈ ਤਿਆਰ ਕੀਤਾ ਗਿਆ ਹੈ ਜਿਨ੍ਹਾਂ ਨੂੰ API ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਦਾ ਪ੍ਰਬੰਧਨ ਕਰਦੇ ਸਮੇਂ ਸ਼ੁੱਧਤਾ ਅਤੇ ਗਤੀ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ।
JSON Schema1. ਮਲਟੀਪਲ ਡਰਾਫਟ ਲਈ ਸਮਰਥਨ
ਭਾਵੇਂ ਤੁਹਾਡਾ ਸਰੋਤ ਸਕੀਮਾ ਡਰਾਫਟ 4, 7, ਜਾਂ 2020-12 ' ਤੇ ਅਧਾਰਤ ਹੈ, ਸਾਡਾ ਇੰਜਣ ਢਾਂਚੇ ਦੀ ਪਛਾਣ ਕਰਦਾ ਹੈ ਅਤੇ ਇਸਨੂੰ ਸਭ ਤੋਂ ਨੇੜਲੇ OpenAPIਬਰਾਬਰ ਨਾਲ ਮੈਪ ਕਰਦਾ ਹੈ।
2. OpenAPI3.0 ਅਤੇ 3.1 ਤਿਆਰ
OpenAPI3.1 ਹੁਣ JSON Schema2019-09 ਦੇ ਨਾਲ ਪੂਰੀ ਤਰ੍ਹਾਂ ਅਨੁਕੂਲ ਹੈ। ਹਾਲਾਂਕਿ, ਜੇਕਰ ਤੁਸੀਂ ਅਜੇ ਵੀ 3.0 ਦੀ ਵਰਤੋਂ ਕਰ ਰਹੇ ਹੋ, ਤਾਂ ਸਾਡਾ ਟੂਲ ਅਨੁਕੂਲਤਾ ਬਣਾਈ ਰੱਖਣ ਲਈ 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)
ਕੀ ਇਹ ਕਨਵਰਟਰ Swagger 2.0 ਦੇ ਅਨੁਕੂਲ ਹੈ?
ਜਦੋਂ ਕਿ ਫੋਕਸ OpenAPI3.x 'ਤੇ ਹੈ, ਤਿਆਰ ਕੀਤੇ ਗਏ ਸਕੀਮਾ ਵੱਡੇ ਪੱਧਰ 'ਤੇ ਸਵੈਗਰ 2.0 ਦੇ ਅਨੁਕੂਲ ਹਨ, ਹਾਲਾਂਕਿ definitionsਭਾਗ ਲਈ ਕੁਝ ਸਮਾਯੋਜਨ ਦੀ ਲੋੜ ਹੋ ਸਕਦੀ ਹੈ।
ਕੀ ਮੇਰਾ ਡੇਟਾ ਮੇਰੇ ਬ੍ਰਾਊਜ਼ਰ ਤੋਂ ਬਾਹਰ ਜਾਂਦਾ ਹੈ?
ਨਹੀਂ। ਸਾਰੇ ਰੂਪਾਂਤਰਣ ਤਰਕ ਤੁਹਾਡੇ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਜਾਵਾ ਸਕ੍ਰਿਪਟ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸਥਾਨਕ ਤੌਰ 'ਤੇ ਹੁੰਦੇ ਹਨ। ਤੁਹਾਡੇ ਸੰਵੇਦਨਸ਼ੀਲ API ਸਕੀਮਾ ਕਦੇ ਵੀ ਸਾਡੇ ਸਰਵਰਾਂ ਨੂੰ ਨਹੀਂ ਭੇਜੇ ਜਾਂਦੇ।
ਕੀ ਮੈਂ ਵੱਡੇ, ਗੁੰਝਲਦਾਰ ਸਕੀਮਾਂ ਨੂੰ ਬਦਲ ਸਕਦਾ ਹਾਂ?
ਹਾਂ। ਸਾਡਾ ਟੂਲ ਬਿਨਾਂ ਪ੍ਰਦਰਸ਼ਨ ਦੇ ਪਛੜਨ ਦੇ ਡੂੰਘਾਈ ਨਾਲ ਨੇਸਟਡ ਸਕੀਮਾਂ ਅਤੇ ਵੱਡੀਆਂ ਵਸਤੂ ਪਰਿਭਾਸ਼ਾਵਾਂ ਨੂੰ ਸੰਭਾਲਣ ਲਈ ਅਨੁਕੂਲਿਤ ਹੈ।