סוואגר (תוכנה)

סוואגר
מפתח SmartBear Software עריכת הנתון בוויקינתונים
סוג רישיון אפאצ'י 2.0 עריכת הנתון בוויקינתונים
swagger.io
לעריכה בוויקינתונים שמשמש מקור לחלק מהמידע בתבנית

סוואגראנגלית: Swagger) היא חבילת כלים למפתחי API, של חברת SmartBear Software[1] ולשעבר גם מפרט שממנו התפתח מפרט OpenAPI.[2]

היסטוריה

פרויקט Swagger API נוצר בשנת 2011 על ידי טוני טאם, מייסד שותף טכני של אתר המילונים וורדניק. במהלך הפיתוח של המוצרים של וורדניק, הצורך באוטומציה של תיעוד API ויצירת SDK לקוח הפך למקור תסכול משמעותי. טאם עיצב ייצוג JSON פשוט של ה-API, תוך בנייה על הגמישות של פרוטוקול HTTP ושימוש בתכונות רבות של כלים שנבנו עבור פרוטוקול SOAP. הקונספט לממשק המשתמש הוצע על ידי Ayush Gupta, שהציע שממשק משתמש אינטראקטיבי יועיל למשתמשי קצה שרוצים "לנסות" ולפתח מול ה-API. ‏Ramesh Pidikiti הוביל את המימוש של מחולל הקוד הראשוני והמעצב/המפתח Zeke Sikelianos טבע את השם Swagger. פרויקט Swagger API הפך לקוד פתוח בספטמבר 2011. זמן קצר לאחר פרסום הפרויקט, נוספו מספר רכיבים חדשים לפרויקט, כולל אימות עצמאי, תמיכה ב-Node.js ו-Ruby on Rails.

בשנותיו הראשונות של סוואגר, השימוש במוצר היה בהיקף צנוע, בעיקר אצל חברות קטנות ומפתחים עצמאיים. לממשקי HTTP בדרך כלל לא היה מנגנון תיאור שקריא למחשבים, וסוואגר סיפקה דרך פשוטה לעשות זאת. טוני הוזמן לפגישה עם כמה ממובילי המחשבה של תעשיית ה-API, כולל ג'ון מוסר (ProgrammableWeb), מארש גרדינר (Apigee, כיום מוצר של גוגל), מרקו פאלאדינו (קונג) וקין ליין (API Evangelist) כדי לדון במאמץ סטנדרטיזציה סביב תיאורי API. אמנם הפגישה לא הניבה תוכנית קונקרטית לעשות זאת, אך היא העלתה את סוואגר על המפה כחידוש קריטי בתחום ה-API.

בזכות השימוש ברישיון הקוד הפתוח Apache 2.0, החלו מספר מוצרים ושירותים מקוונים לכלול את Swagger בהיצע השירותים שלהם, ותהליך זה הואץ במהירות לאחר אימוץ הטכנולוגיה על ידי Apigee, Intuit, Microsoft, IBM ואחרות שהחלו לאמץ בפומבי את פרויקט Swagger.

זמן קצר לאחר יצירת Swagger, הוצגו מבנים חלופיים לתיאור ממשקי API של HTTP, כשהפופולריים ביותר הם API Blueprint באפריל 2013 ו-RESTful API Modeling Language (RAML) בספטמבר 2013.

בנובמבר 2015, SmartBear Software, החברה שתחזק את Swagger, הודיעה שהיא מסייעת ביצירת ארגון חדש, בחסות קרן לינוקס, בשם OpenAPI Initiative. מגוון חברות, כולל גוגל, יבמ ומיקרוסופט הן חברות מייסדות בארגון החדש.[3]

ב-1 בינואר 2016, מפרט Swagger שונה ל- OpenAPI Specification, והועבר למאגר תוכנה חדש ב-GitHub.[4] למרות שהמפרט עצמו לא השתנה, שינוי שם זה סימן את הפיצול בין פורמט תיאור ה-API לבין כלי הקוד הפתוח.

שימושיות

ניתן לחלק את השימוש בכלים בקוד פתוח של Swagger למקרי שימוש שונים: פיתוח, אינטראקציה עם ממשקי API ותיעוד.

פיתוח API

בעת יצירת API, ניתן להשתמש בכלי Swagger כדי ליצור באופן אוטומטי מסמך Open API המבוסס על הקוד עצמו. זה מטמיע את תיאור ה-API בקוד המקור של הפרויקט ונקרא באופן לא פורמלי פיתוח API בשיטת קוד-תחילה או מלמטה למעלה.

לחלופין, באמצעות Swagger Codegen, מפתחים יכולים לנתק את קוד המקור ממסמך ה-API הפתוח, וליצור קוד לקוח ושרת ישירות מהעיצוב. זה מאפשר לדחות את שלב הקידוד.

אינטראקציה עם API

באמצעות פרויקט Swagger Codegen, משתמשי קצה יוצרים SDK עבור הקליינט ישירות ממסמך OpenAPI, מה שמפחית את הצורך בקוד קליינט שנוצר על ידי אדם. נכון לאוגוסט 2017, פרויקט Swagger Codegen תמך ביותר מ-50 שפות ופורמטים שונים ליצירת SDK של קליינט.

לשם המחשה, API שנועד לשרת אתר אינטרנט, ניתן לשימוש באמצעות הרצת הקריאות השונות מתוך דף HTML שמיוצר אוטומטית על ידי Swagger Codegen, בלי שאתר האינטרנט נבנה או הוסיף תמיכה בקריאות API חדשות.

תיעוד ממשקי API

כאשר מתואר על ידי מסמך OpenAPI, ניתן להשתמש בכלי קוד פתוח של Swagger לאינטראקציה ישירה עם ה-API דרך ממשק המשתמש של Swagger . פרויקט זה מאפשר חיבורים ישירות לממשקי API חיים באמצעות ממשק משתמש אינטראקטיבי מבוסס HTML. ניתן להגיש בקשות ישירות מהממשק והאפשרויות שנבדקות על ידי המשתמש בממשק.[5]

קישורים חיצוניים

ויקישיתוף מדיה וקבצים בנושא סוואגר בוויקישיתוף

הערות שוליים

  1. ^ "About". API Documentation & Design Tools for Teams | Swagger (באנגלית אמריקאית). נבדק ב-2022-04-24.{{cite web}}: תחזוקה - ציטוט: url-status (link)
  2. ^ "FAQ - OpenAPI Initiative". OpenAPI Initiative (באנגלית אמריקאית). נבדק ב-2022-04-24.{{cite web}}: תחזוקה - ציטוט: url-status (link)
  3. ^ "New Collaborative Project to Extend Swagger Specification for Building Connected Applications and Services". www.linuxfoundation.org. אורכב מ-המקור ב-2016-04-27. נבדק ב-2016-04-22.
  4. ^ "The OpenAPI Specification". GitHub (באנגלית אמריקאית). 19 בפברואר 2022. נבדק ב-19 בפברואר 2023. {{cite web}}: (עזרה)תחזוקה - ציטוט: url-status (link)
  5. ^ "Documenting Your Existing APIs: API Documentation Made Easy with OpenAPI & Swagger". swagger.io (באנגלית אמריקאית). נבדק ב-21 במרץ 2023. {{cite web}}: (עזרה)תחזוקה - ציטוט: url-status (link)

Read other articles:

Russian cargo spacecraft Progress M-25MTraveling at 420 km over the Atlantic Ocean,the Russian cargo ship docking to the Pirs module.Mission typeISS resupplyOperatorRoskosmosCOSPAR ID2014-067A SATCAT no.40292Mission duration178 days Spacecraft propertiesSpacecraft typeProgress-M s/n 425ManufacturerRKK EnergiaLaunch mass7290 kg Start of missionLaunch date29 October 2014,07:09:43 UTC[1]RocketSoyuz-2.1aLaunch siteBaikonur, Site 31/6 End of missionDisposalDeorbitedDecay date26 April 2015,...

 

Questa voce sull'argomento attori italiani è solo un abbozzo. Contribuisci a migliorarla secondo le convenzioni di Wikipedia. Segui i suggerimenti del progetto di riferimento. Giovanna Pala nel film Mamma mia, che impressione! (1951) Giovanna Pala (Vergato, 15 luglio 1932[1]) è un'attrice italiana. Indice 1 Biografia 2 Vita privata 3 Filmografia 4 Note 5 Altri progetti 6 Collegamenti esterni Biografia Giovane modella con tratti fisici da maggiorata, ottenne il secondo posto ne...

 

Prefektur Tokushima 徳島県PrefekturTranskripsi Jepang • Jepang徳島県 • RōmajiTokushima-ken BenderaLambangNegaraJepangWilayahShikokuPulauShikokuIbu kotaTokushimaPemerintahan • GubernurKamon IizumiLuas • Total4,144,95 km2 (1,60.037 sq mi)Peringkat36thPopulasi (May 1, 2016) • Total751.969 • Peringkat44th • Kepadatan180/km2 (470/sq mi)Kode ISO 3166JP-36Distrik8Munisipalitas24Bu...

Far Cry 5 Publikasi27 Maret 2018GenrePenembak orang pertamaLatar tempatFar Cry universe (en) Bahasa Daftar Arab, Belanda, Ceko, Inggris, Italia, Jepang, Jerman, Korea, Polandia, Portugis Brasil, Prancis, Rusia, Spanyol, Tionghoa Sederhana dan Tionghoa Tradisional 60 Karakteristik teknisPlatformWindows, PlayStation 4 dan Xbox One MesinDunia Engine 2 (en) ModePermainan video pemain tunggal dan permainan video multipemain Formatdistribusi digital, cakram optis dan unduhan digital Metode inputpap...

 

Formula One race 2010 Belgian Grand Prix Race 13 of 19 in the 2010 Formula One World Championship← Previous raceNext race → Race details[1][2]Date 29 August 2010Official name 2010 Formula 1 Belgian Grand PrixLocation Circuit de Spa-Francorchamps, Francorchamps, Wallonia, BelgiumCourse Permanent racing facilityCourse length 7.004 km (4.352 miles)Distance 44 laps, 308.052 km (191.415[a] miles)Weather Intermittent rainAttendance 60,000Pole position...

 

Kesseldorfcomune Kesseldorf – Veduta LocalizzazioneStato Francia RegioneGrand Est Dipartimento Basso Reno ArrondissementWissembourg CantoneWissembourg TerritorioCoordinate48°53′N 8°04′E / 48.883333°N 8.066667°E48.883333; 8.066667 (Kesseldorf)Coordinate: 48°53′N 8°04′E / 48.883333°N 8.066667°E48.883333; 8.066667 (Kesseldorf) Superficie7,2 km² Abitanti435[1] (2009) Densità60,42 ab./km² Altre informazioniCod. postale...

Nama ini merupakan sebuah nama Belanda; nama keluarganya adalah Van der Laan, bukan Laan. Medy van der Laan pada 2015 Medy Catharina van der Laan (lahir 14 Agustus 1968) adalah seorang pensiunan politikus Belanda yang menjabat sebagai sekretaris negara di Kementerian Pendidikan, Budaya dan Sains dalam penugasan Budaya dan Media dalam kabinet Balkenende kedua (2003–2006). Ia sebelumnya menjadi asisten Sekretaris Negara Jacob Kohnstamm di Kementerian Urusan Luar Negeri. Referensi (dalam ...

 

Bulvar RokossovskogoStasiun Metro MoskwaLokasiBogorodskoye DistrictEastern Administrative OkrugMoscowRusiaPemilikMoskovsky MetropolitenJalur!C  1  Jalur Sokolnicheskaya Jumlah peron1 Peron pulauJumlah jalur2LayananBus: 3, 75, 80, 86, 265, 775, 822Tram: 2, 4, 7, 13, 29, 33, 36, 46KonstruksiJenis strukturShallow column triple-vaultKedalaman8 meter (26 ft)Tinggi peron1Informasi lainKode stasiun001SejarahDibuka1 Agustus 1990Nama sebelumnyaUlitsa PodbelskogoOperasi layanan...

 

Para pakar biologi serta seniman dan penyair telah lama menganggap bahwa Bulan mempengaruhi makhluk-makhluk hidup. Efek bulan adalah sebuah dugaan korelasi yang tak terbukti antara tahap-tahap spesifik dari siklus bulan selama sekitar 29.5 hari dan perubahan perilaku dan psikologi pada makhluk-makhluk hidup di Bumi, termasuk manusia. Dalam beberapa kasus, dugaan efek dapat tergantung pada dugaan-dugaan luar, seperti sinar bulan. Dalam kasus lain, seperti perkiraan siklus bulanan menstruasi pa...

Protein-coding gene in humans IRAK2Available structuresPDBOrtholog search: PDBe RCSB List of PDB id codes3MOPIdentifiersAliasesIRAK2, IRAK-2, interleukin 1 receptor associated kinase 2External IDsOMIM: 603304 MGI: 2429603 HomoloGene: 1207 GeneCards: IRAK2 Gene location (Human)Chr.Chromosome 3 (human)[1]Band3p25.3Start10,164,919 bp[1]End10,243,745 bp[1]Gene location (Mouse)Chr.Chromosome 6 (mouse)[2]Band6 E3|6 52.82 cMStart113,615,428 bp[2]End113,67...

 

Artikel ini sebatang kara, artinya tidak ada artikel lain yang memiliki pranala balik ke halaman ini.Bantulah menambah pranala ke artikel ini dari artikel yang berhubungan atau coba peralatan pencari pranala.Tag ini diberikan pada Februari 2023. Before the Next Teardrop FallsBerkas:BeforeTheNextTeardropFalls.jpgAlbum studio karya Freddy FenderDirilis1974GenreTejanoDurasi29:11LabelDotProduserHuey P. MeauxKronologi Freddy Fender Before the Next Teardrop Falls 1974 Recorded Inside Louisiana ...

 

Category of autochthonous religious movements Part of a series onBaltic religion Mythology Prussian Lithuanian Latvian Indo-European Deities Panbaltic Perkūnas Velnias Dievas Saulė Mėnulis Prussian Patollo Peckols Potrimpo Swayxtix Autrimps Aušlavis Bardoayts Kurka Pilnytis Puszajtis Latvian Ūsiņš Ceroklis Jumis Auseklis Laima Dēkla Kārta Lauma Māra Mahte Lithuanian Gabija Žemyna Laima Medeina/Žvorūna Laumė/Ragana Aušrinė Bangpūtys/Vėjopatis Rūgutis Miscellaneous Aitvaras K...

School district in Pennsylvania West Middlesex Area School DistrictAddress3591 Sharon Road West Middlesex, Pennsylvania, 16159-3721United StatesDistrict informationTypePublicOther informationWebsitewww.wmasd.k12.pa.us The West Middlesex Area School District is a small, rural public school district serving the southwestern portion of Mercer County, Pennsylvania. It encompasses the communities of West Middlesex, Shenango Township, and Lackawannock Township. The West Middlesex Area School Distri...

 

Kimberly Dos Ramos Información personalNombre de nacimiento Kimberly Dos Ramos De SousaNombre en español Kimberly Dos Ramos Nacimiento 15 de abril de 1992 (32 años)Caracas, VenezuelaNacionalidad VenezolanaInformación profesionalOcupación actrizAños activa 2000-presente[editar datos en Wikidata] Kimberly Dos Ramos De Sousa (Caracas; 15 de abril de 1992) es una actriz venezolana. Comenzó desde muy temprana edad su carrera actoral con comerciales y promociones para televisi...

 

172 DaysPoster rilis teatrikalSutradaraHadrah Daeng RatuProduser Chand Parwez Servia Fiaz Servia SkenarioArchie HekageryBerdasarkan172 Daysoleh Nadzira ShafaPemeran Yasmin Napper Bryan Domani Yoriko Angeline Penata musikTya SubiaktoSinematograferAdrian SugionoPenyuntingAline JusriaPerusahaanproduksiStarvisionTanggal rilis 23 November 2023 (2023-11-23) (Indonesia) 4 April 2024 (2024-04-04) (Netflix) Durasi103 menitNegaraIndonesiaBahasaIndonesia 172 Days adalah film dram...

Venezuelan politician (born 1967) In this Spanish name, the first or paternal surname is Machado and the second or maternal family name is Parisca. María Corina MachadoMachado in 2023Member of the National Assemblyfor MirandaIn office5 January 2011 – 21 March 2014Succeeded byRicardo Sánchez Personal detailsBorn (1967-10-07) 7 October 1967 (age 56)Caracas, Fourth Republic of VenezuelaPolitical partyVente Venezuela (2012–present)Other politicalaffiliationsUnitary Pla...

 

У этого термина существуют и другие значения, см. Рошфор (значения). Жан Рошфорфр. Jean Rochefort Имя при рождении Жан Рауль Робер Рошфор Дата рождения 29 апреля 1930(1930-04-29)[1][2][…] Место рождения XX округ Парижа, Франция[4][5] Дата смерти 9 октября 2017(2017-10-09)[1&...

 

Quản trị kinh doanh  • Công ty  • Doanh nghiệp  • Tập đoàn Nhân cách pháp lý · Nhóm công ty  · Tổng công ty  · Công ty cổ phần  · Công ty trách nhiệm hữu hạn  · Công ty hợp danh  · Doanh nghiệp nhà nước  · Doanh nghiệp tư nhân  · Hợp tác xã  · Hộ kinh doanh cá thể Quản trị c�...

Индоевропейские языки Индоевропе́йцы — народы — носители индоевропейских языков[1]. Общих предков индоевропейских народов принято называть праиндоевропейцы, или так же индоевропейцы. Содержание 1 Наименование 2 Современные и древние представители 3 Происхож�...

 

Pliocène Données clés Notation chronostratigraphique N2 Notation française p Notation RGF p Équivalences milieu du Redonien Niveau Époque / Série Période / Système - Érathème / Ère-- Éonothème / Éon NéogèneCénozoïquePhanérozoïque StratigraphieÉtendue DébutFin  5,333 Ma  2,58 Ma Miocène PléistocèneQuaternaire Affleurements modifier Sur l'échelle des temps géologiques, le Pliocène est la seconde époque et la plus récente époque géologique du...