[{"data":1,"prerenderedAt":629},["ShallowReactive",2],{"nav_featured_podcast":3,"nav_featured_press_release":21,"navigation_content":30,"engineering_blog_post:podcast-evolving-apis":378},{"uid":4,"title":5,"episodeLabel":6,"dateLabel":7,"episodeArt":8,"href":20},"from-payment-rails-to-connectivity","From Payment Rails to Connectivity, with The Clearing House's David Watson","EPISODE 5","August 18, 2026",{"dimensions":9,"alt":12,"copyright":13,"url":14,"id":15,"edit":16},{"width":10,"height":11},1064,652,"Payments Cannot Fail — Episode 05 with David Watson",null,"\u002F_prismic-media\u002Fd80df2e47c3ecb6f-cFcyPAgzKCMQEaND_Episode-05-David.jpg","cFcyPAgzKCMQEaND",{"x":17,"y":17,"zoom":18,"background":19},0,1,"transparent","\u002Fresources\u002Fpodcasts\u002Ffrom-payment-rails-to-connectivity",{"uid":22,"title":23,"tag":24,"dateLabel":25,"imageUrl":26,"imageAlt":27,"href":28,"imageFit":29},"form3-expands-strategic-partnership-with-sumup","Form3 expands strategic partnership with SumUp to bring real-time SEPA payments to millions of European small businesses","EU","February 25, 2026","\u002F_prismic-media\u002F3e91177f91478610-QA44Gzev0_tdg3ZI_SumUp.jpg","sumup","\u002Fresources\u002Fpress-releases\u002Fform3-expands-strategic-partnership-with-sumup","cover",{"header":31,"platform":59,"solutions":91,"developers":133,"company":155,"resources":184,"partnerships":208,"footer":220,"mobile":325},{"ctaLabel":32,"ctaHref":33,"topNav":34},"TALK TO OUR TEAM","\u002Fcontact",[35,39,43,47,51,55],{"label":36,"href":37,"key":38},"Platform","\u002Fplatform","platform",{"label":40,"href":41,"key":42},"Solutions","\u002Fsolutions","solutions",{"label":44,"href":45,"key":46},"Developers","\u002Fdevelopers","developers",{"label":48,"href":49,"key":50},"Company","\u002Fcompany","company",{"label":52,"href":53,"key":54},"Resources","\u002Fresources","resources",{"label":56,"href":57,"key":58},"Partnerships","\u002Fpartnerships","partnerships",{"sectionEyebrow":60,"primary":61,"productLinks":65,"enterprise":81,"trustFabric":86},"Explore the Platform",{"heading":62,"body":63,"ctaLabel":64,"ctaHref":37},"Our Payments Platform","A resilient, cloud-native platform powering real-time account-to-account payments at global scale.","See How It Works",[66,69,72,75,78],{"label":67,"href":68},"Payments Processing & Gateway","\u002Fpayments-processing-gateway",{"label":70,"href":71},"Orchestration & Intelligent Routing","\u002Forchestration-intelligent-routing",{"label":73,"href":74},"Payments Simulator","\u002Fpayments-simulator",{"label":76,"href":77},"Sponsor Bank Enablement","\u002Fsponsor-bank-enablement",{"label":79,"href":80},"Informed UI","\u002Finformed-ui",{"heading":82,"body":83,"ctaLabel":84,"ctaHref":85},"Form3 Enterprise","Deploy and manage proven cloud-native payments technology in the environment that works for your institution.","Deploy Enterprise","\u002Fplatform\u002Fenterprise",{"heading":87,"body":88,"ctaLabel":89,"ctaHref":90},"Form3 Trust Fabric","Manage TLS certificates, cryptographic vulnerabilities and quantum readiness at scale, with continuous visibility.","Deploy Trust Fabric","\u002Fplatform\u002Ftrust-fabric",{"regionsIntro":92,"regions":98,"industries":118},{"eyebrow":93,"heading":94,"headingLine2":95,"body":96,"ctaLabel":64,"ctaHref":97},"Regions","Global Reach.","Regional Expertise.","A proven payments platform serving organizations worldwide, with specialized experience across North America, United Kingdom, and Europe.","\u002Fglobal",[99,108,113],{"label":100,"description":101,"ctaLabel":102,"href":103,"extraLinks":104},"North America","Real-time infrastructure, through a resilient, multi-cloud platform built for scale and regulatory confidence.","US HOME","\u002Fsolutions\u002Funited-states",[105],{"label":106,"href":107},"CANADA HOME","\u002Fsolutions\u002Fcanada",{"label":109,"description":110,"ctaLabel":111,"href":112},"United Kingdom","Powering account-to-account payments at the heart of the UK financial ecosystem, with proven resilience.","UK HOME","\u002Fsolutions\u002Funited-kingdom",{"label":114,"description":115,"ctaLabel":116,"href":117},"Europe","Enabling secure, real-time and SEPA payments across European markets through a unified, cloud-native platform.","EUROPE HOME","\u002Fsolutions\u002Feurope",{"eyebrow":119,"links":120},"Industries",[121,125,129],{"label":122,"href":123,"iconSrc":124},"Financial Services","\u002Fsolutions\u002Findustries\u002Ffinancial-services","\u002F_prismic-media\u002F29c09c45caa89db9-kbUHZmgTmuIMbo1t_FinancialServices_menu.svg",{"label":126,"href":127,"iconSrc":128},"Fintech","\u002Fsolutions\u002Findustries\u002Ffintech","\u002F_prismic-media\u002F6de3e7cb4dd8d874-SjwNe6Nh-bbuTi0P_Fintech_menu.svg",{"label":130,"href":131,"iconSrc":132},"Government","\u002Fsolutions\u002Findustries\u002Fgovernment","\u002F_prismic-media\u002Fe71bc3a74a1d2142-kaGgdituzKDnVTbm_Government_menu.svg",{"engineering":134,"api":142,"pressEyebrow":154},{"eyebrow":135,"links":136},"Engineering",[137,139],{"label":135,"href":138},"\u002Fengineering",{"label":140,"href":141},"Accreditations","\u002Faccreditations",{"eyebrow":143,"links":144},"API",[145,148,151],{"label":146,"href":147},"API Docs","https:\u002F\u002Fwww.api-docs.form3.tech\u002F",{"label":149,"href":150},"API Tutorials","https:\u002F\u002Fwww.api-docs.form3.tech\u002Fapi\u002Ftutorials\u002Fgetting-started\u002Fintroduction",{"label":152,"href":153},"API Status","https:\u002F\u002Fstatus.form3.tech\u002F","Latest Press Release",{"about":156,"people":171,"podcastEyebrow":183},{"eyebrow":157,"links":158},"About",[159,162,165,168],{"label":160,"href":161},"Our Story","\u002Fcompany\u002Four-story",{"label":163,"href":164},"Our Team","\u002Fcompany\u002Fteam",{"label":166,"href":167},"Our Success & Strategic Approach","\u002Fcompany\u002Four-success",{"label":169,"href":170},"Customer Stories","\u002Fcompany\u002Fcustomer-stories",{"eyebrow":172,"links":173},"People",[174,177,180],{"label":175,"href":176},"Careers","\u002Fcompany\u002Fcareers",{"label":178,"href":179},"Vacancies","\u002Fcompany\u002Fvacancies",{"label":181,"href":182},"Culture","\u002Fcompany\u002Fculture","Latest Podcast",{"intro":185,"links":189,"pressEyebrow":154,"podcastEyebrow":183},{"eyebrow":52,"heading":186,"body":187,"ctaLabel":188,"ctaHref":53},"Form3 Resources","Our Resources bring together thought leadership, engineering insights, payments expertise, webinars, podcasts, whitepapers, company news and stories from our teams—all in one place.","LEARN MORE",[190,193,196,199,202,205],{"label":191,"href":192},"Payments Cannot Fail Podcast","\u002Fresources\u002Fpodcasts",{"label":194,"href":195},"Press Releases","\u002Fresources\u002Fpress-releases",{"label":197,"href":198},"Payment Insights","\u002Fresources\u002Fpayment-insights",{"label":200,"href":201},"Culture Blog","\u002Fresources\u002Fculture-blog",{"label":203,"href":204},"Engineering Blog","\u002Fresources\u002Fengineering-blog",{"label":206,"href":207},"Events","\u002Fevents",{"intro":209,"links":213,"pressEyebrow":154},{"eyebrow":56,"heading":210,"body":211,"ctaLabel":212,"ctaHref":57},"Partner with Form3","Explore how Form3 works with banks, fintechs, cloud providers, technology platforms and system integrators to accelerate payment modernization, strengthen customer offerings and unlock new opportunities for growth.","Let's Partner Together",[214,217],{"label":215,"href":216},"Technical & Ecosystem Partners","\u002Fpartnerships\u002Ftechnical-ecosystem",{"label":218,"href":219},"Channel & Distribution Partners","\u002Fpartnerships\u002Fchannel-distribution",{"platform":221,"region":229,"development":240,"company":248,"resources":259,"partnerships":267,"stayConnected":272,"legalLinks":292,"certifications":314},{"title":36,"links":222},[223,224,225,226,227,228],{"label":62,"href":37},{"label":67,"href":68},{"label":70,"href":71},{"label":73,"href":74},{"label":76,"href":77},{"label":79,"href":80},{"title":230,"links":231},"Region",[232,234,236,237,238],{"label":233,"href":97},"Global",{"label":235,"href":103},"United States",{"label":109,"href":112},{"label":114,"href":117},{"label":239,"href":107},"Canada",{"title":241,"links":242},"Development",[243,244,245,246,247],{"label":135,"href":138},{"label":140,"href":141},{"label":146,"href":147},{"label":149,"href":150},{"label":152,"href":153},{"title":48,"links":249},[250,251,252,253,254,255,256],{"label":160,"href":161},{"label":163,"href":164},{"label":169,"href":170},{"label":175,"href":176},{"label":178,"href":179},{"label":181,"href":182},{"label":257,"href":258},"Net Zero","\u002Fcompany\u002Fnet-zero",{"title":52,"links":260},[261,262,263,264,265,266],{"label":186,"href":53},{"label":191,"href":192},{"label":194,"href":195},{"label":200,"href":201},{"label":203,"href":204},{"label":206,"href":207},{"title":56,"links":268},[269,270,271],{"label":210,"href":57},{"label":215,"href":216},{"label":218,"href":219},{"title":273,"body":274,"ctaLabel":32,"ctaHref":33,"social":275},"Stay Connected","Form3 is a global account-to-account financial fabric delivering a proven payments platform trusted by banks and fintechs to deliver resilient, real-time payment experiences for their customers at scale.",[276,280,284,288],{"label":277,"href":278,"icon":279},"LinkedIn","https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fform3-financial-cloud\u002F","linkedin",{"label":281,"href":282,"icon":283},"X","https:\u002F\u002Fwww.x.com\u002FForm3Cloud","x",{"label":285,"href":286,"icon":287},"YouTube","https:\u002F\u002Fwww.youtube.com\u002F@Form3Cloud","youtube",{"label":289,"href":290,"icon":291},"Instagram","https:\u002F\u002Fwww.instagram.com\u002Fform3.tech","instagram",[293,296,299,302,305,308,311],{"label":294,"href":295},"Terms & Conditions","\u002Flegal\u002Fterms-and-conditions",{"label":297,"href":298},"Privacy Policy","\u002Flegal\u002Fdata-privacy-statement",{"label":300,"href":301},"Recruitment Data Policy","\u002Flegal\u002Frecruitment-data-policy",{"label":303,"href":304},"Modern Slavery Statement","\u002Flegal\u002Fmodern-slavery",{"label":306,"href":307},"License","\u002Flegal\u002Flicense",{"label":309,"href":310},"Cookie Policy","\u002Flegal\u002Fcookie-policy",{"label":312,"href":313},"Manage Cookies","#cookies",[315,317,319,321,323],{"label":316},"ISO 27001",{"label":318},"ISO 27017",{"label":320},"ISO 27018",{"label":322},"ISAE 3000 SOC 2 Type II",{"label":324},"ISO 22301",{"platform":326,"solutions":341,"developers":355,"company":365,"resources":366,"partnerships":374},[327,329,339,340],{"kind":328,"label":62,"href":37},"link",{"kind":330,"label":60,"children":331},"group",[332,333,334,335,337],{"label":67,"href":68},{"label":70,"href":71},{"label":73,"href":74},{"label":76,"href":336},"\u002Fplatform\u002Fsponsor-bank-enablement",{"label":79,"href":338},"\u002Fplatform\u002Finform3d-ui",{"kind":328,"label":82,"href":85},{"kind":328,"label":87,"href":90},[342,344,350],{"kind":328,"label":233,"href":343},"\u002Fsolutions\u002Fglobal",{"kind":330,"label":93,"children":345},[346,347,348,349],{"label":235,"href":103},{"label":239,"href":107},{"label":109,"href":112},{"label":114,"href":117},{"kind":330,"label":119,"children":351},[352,353,354],{"label":122,"href":123},{"label":126,"href":127},{"label":130,"href":131},[356,360],{"kind":330,"label":135,"children":357},[358,359],{"label":135,"href":138},{"label":140,"href":141},{"kind":330,"label":143,"children":361},[362,363,364],{"label":146,"href":147},{"label":149,"href":150},{"label":152,"href":153},[],[367,368,369,370,371,372,373],{"kind":328,"label":186,"href":53},{"kind":328,"label":191,"href":192},{"kind":328,"label":194,"href":195},{"kind":328,"label":197,"href":198},{"kind":328,"label":200,"href":201},{"kind":328,"label":203,"href":204},{"kind":328,"label":206,"href":207},[375,376,377],{"kind":328,"label":210,"href":57},{"kind":328,"label":215,"href":216},{"kind":328,"label":218,"href":219},{"id":379,"uid":380,"url":381,"type":382,"href":383,"tags":384,"first_publication_date":385,"last_publication_date":386,"slugs":387,"linked_documents":389,"lang":390,"alternate_languages":391,"data":392},"alz1EREAACsAUWe0","podcast-evolving-apis","\u002Fresources\u002Fengineering-blog\u002Fpodcast-evolving-apis","engineering_blog_post","https:\u002F\u002Fform3-website.cdn.prismic.io\u002Fapi\u002Fv2\u002Fdocuments\u002Fsearch?ref=apnMZxEAACcAKWxv&q=%5B%5B%3Ad+%3D+at%28document.id%2C+%22alz1EREAACsAUWe0%22%29+%5D%5D",[],"2026-07-19T16:21:54+0000","2026-08-27T02:06:55+0000",[388],"ep-33-.tech---designing-and-evolving-apis",[],"en-us",[],{"title":393,"excerpt":394,"card_image":395,"published_date":401,"reading_time":402,"tag":403,"dek":394,"featured_image":404,"about_form3":411,"client_about_heading":13,"client_about_body":412,"author_name":413,"author_title":414,"author_photo":415,"author_bio":423,"author_linkedin":428,"slices":433,"meta_title":393,"meta_description":394},".tech Podcast - Designing and Evolving APIs","Arnaud Lauret aka. \"The API handyman\" is an OpenAPI Lead at Postman. He joins us to share his expertise on API design and maintenance, including tips for evolving APIs and how the OpenAPI specification can make the lives of API designers easier.",{"dimensions":396,"alt":393,"copyright":13,"url":398,"id":399,"edit":400},{"width":397,"height":397},800,"\u002F_prismic-media\u002F0df5d3c79c413d64-DeMify0jzUOXZNNb_podcast-evolving-apis.png","DeMify0jzUOXZNNb",{"x":17,"y":17,"zoom":18,"background":19},"2022-06-20",5,"Blogs",{"dimensions":405,"alt":13,"copyright":13,"url":408,"id":409,"edit":410},{"width":406,"height":407},1200,855,"\u002F_prismic-media\u002F3fcfc9525438cf92-jl5IISlX3o3TCpLS_75e9d139-1d5a-4b49-86c0-72d63d9.png","jl5IISlX3o3TCpLS",{"x":17,"y":17,"zoom":18,"background":19},[],[],"Adelina Simion","Technology Evangelist",{"dimensions":416,"alt":413,"copyright":13,"url":419,"id":420,"edit":421},{"width":417,"height":418},317,474,"\u002F_prismic-media\u002Fe08313b6ab610487-38TSoXRVp2tWVmyC_31a4a6dc-d773-477b-bdf0-7f2e1d8.jpg","38TSoXRVp2tWVmyC",{"x":17,"y":17,"zoom":18,"background":422},"#ffffff",[424],{"type":425,"text":426,"spans":427},"paragraph","Adelina is a polyglot engineer and developer relations professional, with a decade of technical experience at multiple startups in London. She started her career as a Java backend engineer, converted later to Go, and then transitioned to a full-time developer relations role. She has published multiple online courses about Go on the LinkedIn Learning platform, helping thousands of developers up-skill with Go. She has a passion for public speaking, having presented on cloud architectures at major European conferences. Adelina holds an MSc. Mathematical Modelling and Computing degree.",[],{"link_type":429,"key":430,"url":431,"target":432},"Web","5db1edde-c889-4223-b7f1-54e9e235248b","https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Fadelina-simion\u002F","_blank",[434,468,498,529,588,607],{"variation":435,"version":436,"items":437,"primary":438,"id":466,"slice_type":467,"slice_label":13},"default","",[],{"eyebrow":13,"heading":439,"body":444,"cta_label":448,"cta_link":449,"aside_type":13,"aside_image":452,"aside_video":453,"aside_video_poster":455,"aside_video_reduced_motion":456,"aside_video_url":13,"aside_embed":457,"pardot_form_url":13,"form_submit_label":13,"form_variant":458,"form_heading":13,"redirect_on_success":459,"theme":461,"overlay_pattern":462,"background_continuation":463,"media_position":464,"aside_vertical_align":465},[440],{"type":441,"text":442,"spans":443},"heading2","Ep 33 .tech - Designing and Evolving APIs",[],[445],{"type":425,"text":446,"spans":447},"Listen on Form3’s .tech podcast.",[],"LISTEN TO EPISODE",{"link_type":429,"key":450,"url":451},"176582fe-a135-4326-9382-09c0f319ce78","https:\u002F\u002Ftechpodcast.form3.tech\u002Fepisodes\u002Fep-33-tech-designing-and-evolving-apis-UC6w_iYT",{},{"link_type":454},"Media",{},{},{},"Contact (default)",{"link_type":460},"Document","Light","None","Solid color (no gradient)","Right","Top of section","content_block$85ea0320-a77a-4a0e-b572-65865b58327b","content_block",{"variation":435,"version":469,"items":470,"primary":471,"id":496,"slice_type":497,"slice_label":13},"initial",[],{"body":472},[473],{"type":425,"text":474,"spans":475},"Arnaud Lauret is currently working on the Postman Open Technology team. The team educates engineers and organisations to take advantage of APIs. Arnaud shares his knowledge on his blog apihandyman.io and has also written the book \"The Design of Web APIs\".",[476,481,486,491],{"start":17,"end":477,"type":478,"data":479},13,"hyperlink",{"link_type":429,"url":480},"https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Farnaudlauret\u002F",{"start":482,"end":483,"type":478,"data":484},42,49,{"link_type":429,"url":485},"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fpostman-platform\u002F",{"start":487,"end":488,"type":478,"data":489},185,199,{"link_type":429,"url":490},"https:\u002F\u002Fapihandyman.io\u002F",{"start":492,"end":493,"type":478,"data":494},230,254,{"link_type":429,"url":495},"https:\u002F\u002Fwww.manning.com\u002Fbooks\u002Fthe-design-of-web-apis","rich_text$b52813f1-43f0-4116-9756-e0240f772e04","rich_text",{"variation":435,"version":469,"items":499,"primary":500,"id":528,"slice_type":497,"slice_label":13},[],{"body":501},[502,505,522,525],{"type":441,"text":503,"spans":504},"What is an API?",[],{"type":425,"text":506,"spans":507},"Historically, APIs have been thought as remote interfaces that allow software to communicate over a local network or the Internet. Now, they are interfaces that allow to provide a service that others don't want to build from scratch. If you build something really well, you can turn it into an API for others to leverage. For example, Stripe or Twilio allow to build payments or communication simply.",[508,513,518],{"start":509,"end":510,"type":478,"data":511},335,341,{"link_type":429,"url":512},"https:\u002F\u002Fstripe.com\u002Fdocs\u002Fapi",{"start":514,"end":515,"type":478,"data":516},345,351,{"link_type":429,"url":517},"https:\u002F\u002Fgithub.com\u002Fform3tech\u002Ftech-evangelist-team\u002Fblob\u002Fmaster\u002Fblogposts\u002F15-06-2022-ep33-podcast\u002Fwww.twilio.com\u002Fdocs\u002Fusage\u002Fapi",{"start":519,"end":520,"type":521},393,399,"em",{"type":425,"text":523,"spans":524},"In order to be easy to use, APIs should be consistent, so that users don't have to change their integration often. The consistency of an API allows users to guess how it will work, without having to read the documentation. Arnaud is in favour of consistency and should always be the first choice of API designers.",[],{"type":425,"text":526,"spans":527},"However, sometimes design patterns simply don't fit the problem. It can be a tricky tradeoff to choose between providing a suboptimal solution that fits your design and a better solution that surprises users. Arnaud prefers to introduce a new pattern to fit the usecase, as opposed to forcing a pattern that doesn't really fit.",[],"rich_text$d6d7aa5b-e0a1-464e-adc4-5123e4d838b5",{"variation":435,"version":469,"items":530,"primary":531,"id":587,"slice_type":497,"slice_label":13},[],{"body":532},[533,536,539,545,549,552,557,560,563,568,571,574,577,580],{"type":441,"text":534,"spans":535},"Evolving APIs",[],{"type":425,"text":537,"spans":538},"APIs can become difficult to change if some poor design decisions are made in the very beginning. You need to prepare your APIs to accept change gracefully. Here are some things you can do:",[],{"type":425,"text":540,"spans":541},"Choose extensible data types.",[542],{"start":17,"end":543,"type":544},29,"strong",{"type":546,"text":547,"spans":548},"list-item","Prefer strings over booleans to represent statuses. This will allow you to change your workflows and add new statuses as required.",[],{"type":546,"text":550,"spans":551},"Encapsulate data in objects, wrapping lists, atomics or responses. This will allow you to add metadata alongside anything you return without the need to make breaking changes.",[],{"type":425,"text":553,"spans":554},"Create workflows with independent usable steps.",[555],{"start":17,"end":556,"type":544},47,{"type":546,"text":558,"spans":559},"Workflows typically map the users workflows. If a changes comes from the users, then the API will have to change the mapped process as well.",[],{"type":546,"text":561,"spans":562},"Building workflows in reusable steps will allow others to use the workflow as well.",[],{"type":425,"text":564,"spans":565},"Keep things as simple as possible.",[566],{"start":17,"end":567,"type":544},34,{"type":425,"text":569,"spans":570},"If you do need to make a breaking change, Arnaud recommends a middle step. For example, if you have a status as a boolean, then you can add a new string field and deprecate the old status. If you do this in the beginning, then you will begin to get a better idea of the domain that your API is representing. Perhaps your API won't be as beautiful as you wish, but it will still deliver functionality to your users.",[],{"type":425,"text":572,"spans":573},"Then, when you introduce new features\u002Ffunctionality in your API, you can clean up your interfaces and let your consumers know how to adjust to match the new version.",[],{"type":425,"text":575,"spans":576},"However, you will have to provide multiple versions of your API as users migrate to the new functionality. To do that, you have two options:",[],{"type":546,"text":578,"spans":579},"Duplicate your infrastructure with multiple implementations running side by side. This is not recommended as multiple backend services will have to handle the versions.",[],{"type":546,"text":581,"spans":582},"Have a single implementation that will be able to expose the multiple contracts of your API versions. Older requests can be mapped to the new version internally and other services only need to handle one request. The Stripe API uses this transformation strategy in production. ",[583],{"start":584,"end":585,"type":478,"data":586},217,227,{"link_type":429,"url":512},"rich_text$7408eb95-8565-4d4b-a932-8598d3a71c8e",{"variation":435,"version":469,"items":589,"primary":590,"id":606,"slice_type":497,"slice_label":13},[],{"body":591},[592,595,603],{"type":441,"text":593,"spans":594},"GraphQL",[],{"type":425,"text":596,"spans":597},"Arnaud has mixed feelings regarding GraphQL, which was developed by Facebook to make API design easier. However, it does not prevent introducing breaking changes, even though it allows easier testing.",[598],{"start":599,"end":600,"type":478,"data":601},36,43,{"link_type":429,"url":602},"https:\u002F\u002Fgraphql.org\u002F",{"type":425,"text":604,"spans":605},"It solves some problems regarding performance, but you still have to design your APIs and models. You gain visibility on how your API is used, but you lose the ability to read the usage of it easily.",[],"rich_text$382029fc-4424-45b7-9ce2-b27ba756da55",{"variation":435,"version":469,"items":608,"primary":609,"id":628,"slice_type":497,"slice_label":13},[],{"body":610},[611,614,622,625],{"type":441,"text":612,"spans":613},"The OpenAPI specification",[],{"type":425,"text":615,"spans":616},"The OpenAPI specification is a machine readable, but human friendly format to describe REST web APIs taking advantage of the HTTP protocol.",[617],{"start":618,"end":619,"type":478,"data":620},4,25,{"link_type":429,"url":621},"https:\u002F\u002Fspec.openapis.org\u002Foas\u002Fv3.1.0",{"type":425,"text":623,"spans":624},"The specification, formerly known as the Swagger specification, was originally used to document APIs. Then, it was used in a design first approach to describe your API once you know what you want it to do. You can then use the specification to generate documentation, code, clients, mocks and tests, as well as configure API gateways. It can also validate that your API is satisfying your organisation's requirements.",[],{"type":425,"text":626,"spans":627},"There are many uses of the specification and we are just scratching the top of it! Make sure you take advantage of the OpenAPI ecosystem if you are designing your APIs.",[],"rich_text$d35603e0-dc1d-4dc0-bccd-13f032d2d459",1788466508584]