https://yonatankarp.github.io/he/tags/openapi/Recent content in Openapi on Yonatan Karp-RudinHugoheWed, 14 Dec 2022 00:00:00 +0100https://yonatankarp.github.io/he/blog/build-domain-gateway-openapi/Wed, 14 Dec 2022 00:00:00 +0100https://yonatankarp.github.io/he/blog/build-domain-gateway-openapi/<div class="editors-note"> <p><strong>TL;DR:</strong> המאמר הזה מסביר מה זה domain gateway, איך לבנות אחד ולמה תרצו אותו.</p> </div> <h2 id="מה-זה-domain-gateway">מה זה Domain Gateway?</h2> <p>domain gateway הוא מקרה פרטי של ה-API gateway pattern. האתר <a href="https://java-design-patterns.com/patterns/api-gateway/">java-design-patterns</a> מגדיר את ה-gateway pattern כך:</p> <blockquote> <p>With the Microservices pattern, a client may need data from multiple different microservices. If the client called each microservice directly, that could contribute to longer load times, since the client would have to make a network request for each microservice called. Moreover, having the client call each microservice directly ties the client to that microservice – if the internal implementations of the microservices change (for example, if two microservices are combined sometime in the future) or if the location (host and port) of a microservice changes, then every client that makes use of those microservices must be updated. The intent of the API Gateway pattern is to alleviate some of these issues. In the API Gateway pattern, an additional entity (the API Gateway) is placed between the client and the microservices. The job of the API Gateway is to aggregate the calls to the microservices. Rather than the client calling each microservice individually, the client calls the API Gateway a single time. The API Gateway then calls each of the microservices that the client needs.</p>https://yonatankarp.github.io/he/blog/openapi-robust-restful-api/Sun, 04 Dec 2022 00:00:00 +0100https://yonatankarp.github.io/he/blog/openapi-robust-restful-api/<div class="editors-note"> <p><strong>הערת עורך:</strong> הפוסט הזה נכתב על ידי במקור ופורסם בבלוג של SumUp. אבל הרבה השתנה מאז. אני כבר לא עובד ב-SumUp, OpenAPI שחרר שתי גרסאות major, ל-Spring Boot היה release major, ואפילו ל-Gradle היו כמה releases major. לא רק זאת, כישורי הכתיבה שלי השתפרו דרמטית מאז, ולאורך זמן מצאתי כמה טעויות קטנות במאמר המקורי. מאחר שהמאמר המקורי הוא אחד המוצלחים שלי, החלטתי לכתוב אותו מחדש ולפרסם גרסה מעודכנת.</p> </div> <h2 id="מבוא">מבוא</h2> <h3 id="restful-api--הצד-המכוער">RESTful API — הצד המכוער</h3> <p>כמהנדסת/מהנדס backend, פיתחתי APIs רבים ב-REST במהלך הקריירה שלי. אחת הבעיות הכי מעצבנות שנתקלתי בה שוב ושוב הייתה חוסר בשילוב חלק בין ה-backend לבין הלקוחות. שגיאות כתיב ב-URLs, חוסר עקביות ב-JSON (camel case לעומת snake case), העברת ערכים מהסוג הלא נכון (לדוגמה, string במקום integer) ועוד טעויות דומות קרו לי הרבה פעמים.</p>