5:[["$","$L20",null,{"className":"container-sm docs-mobile-menu md:hidden","menuData":[{"name":"search-bar-docs","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:search-bar-docs:title","isUnderCurrentDocsTree":true},{"name":"index","route":"/docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:2:frontMatter","title":"Home","type":"doc","isUnderCurrentDocsTree":true},{"name":"introduction","route":"/docs/introduction","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:3:frontMatter","title":"Introduction","type":"doc","isUnderCurrentDocsTree":true},{"name":"core-concepts","route":"/docs/core-concepts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:4:frontMatter","title":"Core Concepts","type":"doc","isUnderCurrentDocsTree":true},{"name":"sdks-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:sdks-section:title","isUnderCurrentDocsTree":true},{"name":"create-client-sdks","route":"/docs/create-client-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:6:frontMatter","title":"Generate SDKs","type":"doc","isUnderCurrentDocsTree":true},{"name":"prep-openapi","route":"/docs/prep-openapi","children":[{"name":"best-practices","route":"/docs/prep-openapi/best-practices","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:0:frontMatter","title":"OpenAPI overview and best practices","type":"doc","isUnderCurrentDocsTree":true},{"name":"linting","route":"/docs/prep-openapi/linting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:1:frontMatter","title":"OpenAPI document linting","type":"doc","isUnderCurrentDocsTree":true},{"name":"maintenance","route":"/docs/prep-openapi/maintenance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:2:frontMatter","title":"Speakeasy Suggest","type":"doc","isUnderCurrentDocsTree":true},{"name":"overlays","route":"/docs/prep-openapi/overlays","children":[{"name":"apply-overlays","route":"/docs/prep-openapi/overlays/apply-overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:3:children:0:frontMatter","title":"Apply an overlay","type":"doc","isUnderCurrentDocsTree":true},{"name":"create-overlays","route":"/docs/prep-openapi/overlays/create-overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:3:children:1:frontMatter","title":"Create overlays","type":"doc","isUnderCurrentDocsTree":true}],"title":"Overlays","type":"doc","isUnderCurrentDocsTree":true},{"name":"transformations","route":"/docs/prep-openapi/transformations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:4:frontMatter","title":"Transformations","type":"doc","isUnderCurrentDocsTree":true}],"title":"Prepare OpenAPI Spec","type":"doc","isUnderCurrentDocsTree":true},{"name":"customize","route":"/docs/customize","children":[{"name":"basics","route":"/docs/customize/basics","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:1:frontMatter","title":"Customization Basics","type":"doc","isUnderCurrentDocsTree":true},{"name":"structure","route":"/docs/customize/structure","children":[{"name":"imports","route":"/docs/customize/structure/imports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:2:children:0:frontMatter","title":"Customize imports","type":"doc","isUnderCurrentDocsTree":true},{"name":"namespaces","route":"/docs/customize/structure/namespaces","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:2:children:1:frontMatter","title":"Customize namespaces","type":"doc","isUnderCurrentDocsTree":true}],"title":"Structure","type":"doc","isUnderCurrentDocsTree":true},{"name":"data-model","route":"/docs/customize/data-model","children":[{"name":"types","route":"/docs/customize/data-model/types","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:1:frontMatter","title":"Types","type":"doc","isUnderCurrentDocsTree":true},{"name":"enums","route":"/docs/customize/data-model/enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:2:frontMatter","title":"Enums","type":"doc","isUnderCurrentDocsTree":true},{"name":"oneof-schemas","route":"/docs/customize/data-model/oneof-schemas","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:3:frontMatter","title":"OneOf","type":"doc","isUnderCurrentDocsTree":true},{"name":"complex-numbers","route":"/docs/customize/data-model/complex-numbers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:4:frontMatter","title":"Complex Numbers","type":"doc","isUnderCurrentDocsTree":true}],"title":"Data Model","type":"doc","isUnderCurrentDocsTree":true},{"name":"methods","route":"/docs/customize/methods","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:4:frontMatter","title":"Customize methods","type":"doc","isUnderCurrentDocsTree":true},{"name":"responses","route":"/docs/customize/responses","children":[{"name":"responses","route":"/docs/customize/responses/responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:5:children:1:frontMatter","title":"Customize Responses","type":"doc","isUnderCurrentDocsTree":true},{"name":"errors","route":"/docs/customize/responses/errors","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:5:children:2:frontMatter","title":"Error Handling","type":"doc","isUnderCurrentDocsTree":true}],"title":"Responses & Error Handling","type":"doc","isUnderCurrentDocsTree":true},{"name":"globals","route":"/docs/customize/globals","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:6:frontMatter","title":"Global Parameters","type":"doc","isUnderCurrentDocsTree":true},{"name":"servers","route":"/docs/customize/servers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:7:frontMatter","title":"Configure servers","type":"doc","isUnderCurrentDocsTree":true},{"name":"deprecations","route":"/docs/customize/deprecations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:8:frontMatter","title":"Deprecations","type":"doc","isUnderCurrentDocsTree":true},{"name":"authentication","route":"/docs/customize/authentication","children":[{"name":"overview","route":"/docs/customize/authentication/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:1:frontMatter","title":"Overview","type":"doc","isUnderCurrentDocsTree":true},{"name":"configuration","route":"/docs/customize/authentication/configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:2:frontMatter","title":"Configuration Options","type":"doc","isUnderCurrentDocsTree":true},{"name":"simple-schemes","route":"/docs/customize/authentication/simple-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:3:frontMatter","title":"Standard security schemes","type":"doc","isUnderCurrentDocsTree":true},{"name":"oauth","route":"/docs/customize/authentication/oauth","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:4:frontMatter","title":"OAuth 2.0 Authentication","type":"doc","isUnderCurrentDocsTree":true},{"name":"custom-security-schemes","route":"/docs/customize/authentication/custom-security-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:5:frontMatter","title":"Custom Security Schemes","type":"doc","isUnderCurrentDocsTree":true},{"name":"security-callbacks","route":"/docs/customize/authentication/security-callbacks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:6:frontMatter","title":"Security Callbacks","type":"doc","isUnderCurrentDocsTree":true}],"title":"Security & Authentication","type":"doc","isUnderCurrentDocsTree":true},{"name":"runtime","route":"/docs/customize/runtime","children":[{"name":"retries","route":"/docs/customize/runtime/retries","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:1:frontMatter","title":"Enable Retries","type":"doc","isUnderCurrentDocsTree":true},{"name":"timeouts","route":"/docs/customize/runtime/timeouts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:2:frontMatter","title":"Enable Timeouts","type":"doc","isUnderCurrentDocsTree":true},{"name":"pagination","route":"/docs/customize/runtime/pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:3:frontMatter","title":"Enable Pagination","type":"doc","isUnderCurrentDocsTree":true},{"name":"streaming","route":"/docs/customize/runtime/streaming","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:4:frontMatter","title":"Enable Streaming","type":"doc","isUnderCurrentDocsTree":true},{"name":"server-sent-events","route":"/docs/customize/runtime/server-sent-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:5:frontMatter","title":"Enable Server-Sent Events","type":"doc","isUnderCurrentDocsTree":true},{"name":"jsonl-events","route":"/docs/customize/runtime/jsonl-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:6:frontMatter","title":"Enable JSON Lines Responses","type":"doc","isUnderCurrentDocsTree":true},{"name":"custom-http-client","route":"/docs/customize/runtime/custom-http-client","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:7:frontMatter","title":"Customize HTTP Client","type":"doc","isUnderCurrentDocsTree":true},{"name":"override-accept-headers","route":"/docs/customize/runtime/override-accept-headers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:8:frontMatter","title":"Override accept headers","type":"doc","isUnderCurrentDocsTree":true}],"title":"SDK Behavior","type":"doc","isUnderCurrentDocsTree":true},{"name":"webhooks","route":"/docs/customize/webhooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:11:frontMatter","title":"Add webhooks to your SDKs","type":"doc","isUnderCurrentDocsTree":true},{"name":"code","route":"/docs/customize/code","children":[{"name":"code-regions","route":"/docs/customize/code/code-regions","children":[{"name":"overview","route":"/docs/customize/code/code-regions/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:1:frontMatter","title":"Custom code regions","type":"doc","isUnderCurrentDocsTree":true},{"name":"python","route":"/docs/customize/code/code-regions/python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:2:frontMatter","title":"Custom code regions in Python","type":"doc","isUnderCurrentDocsTree":true},{"name":"typescript","route":"/docs/customize/code/code-regions/typescript","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:3:frontMatter","title":"Custom code regions in TypeScript","type":"doc","isUnderCurrentDocsTree":true},{"name":"java","route":"/docs/customize/code/code-regions/java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:4:frontMatter","title":"Custom code regions in Java","type":"doc","isUnderCurrentDocsTree":true}],"title":"Code Regions","type":"doc","isUnderCurrentDocsTree":true},{"name":"monkey-patching","route":"/docs/customize/code/monkey-patching","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:2:frontMatter","title":"Monkey patching","type":"doc","isUnderCurrentDocsTree":true},{"name":"sdk-hooks","route":"/docs/customize/code/sdk-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:3:frontMatter","title":"Custom code with SDK hooks","type":"doc","isUnderCurrentDocsTree":true}],"title":"Add Custom Code","type":"doc","isUnderCurrentDocsTree":true},{"name":"typescript","route":"/docs/customize/typescript","children":[{"name":"additional-index-exports","route":"/docs/customize/typescript/additional-index-exports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:0:frontMatter","title":"Additional index exports","type":"doc","isUnderCurrentDocsTree":true},{"name":"configuring-module-format","route":"/docs/customize/typescript/configuring-module-format","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:1:frontMatter","title":"Configuring module format","type":"doc","isUnderCurrentDocsTree":true},{"name":"disabling-barrel-files","route":"/docs/customize/typescript/disabling-barrel-files","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:2:frontMatter","title":"Disabling barrel files","type":"doc","isUnderCurrentDocsTree":true},{"name":"model-validation-and-serialization","route":"/docs/customize/typescript/model-validation-and-serialization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:3:frontMatter","title":"Model validation and serialization","type":"doc","isUnderCurrentDocsTree":true},{"name":"react-hooks","route":"/docs/customize/typescript/react-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:4:frontMatter","title":"Generating React Hooks from OpenAPI/Swagger","type":"doc","isUnderCurrentDocsTree":true}],"title":"TypeScript","type":"doc","isUnderCurrentDocsTree":true}],"title":"Customize","type":"doc","isUnderCurrentDocsTree":true},{"name":"manage","route":"/docs/manage","children":[{"name":"versioning","route":"/docs/manage/versioning","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:1:frontMatter","title":"Version Control","type":"doc","isUnderCurrentDocsTree":true},{"name":"github-setup","route":"/docs/manage/github-setup","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:2:frontMatter","title":"Github Setup","type":"doc","isUnderCurrentDocsTree":true},{"name":"sdk-sandbox","route":"/docs/manage/sdk-sandbox","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:3:frontMatter","title":"Enable Sandbox","type":"doc","isUnderCurrentDocsTree":true},{"name":"migrate","route":"/docs/manage/migrate","children":[{"name":"poetry-2-update","route":"/docs/manage/migrate/poetry-2-update","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:0:frontMatter","title":"Poetry 2.0 and Python 3.9 Updates","type":"doc","isUnderCurrentDocsTree":true},{"name":"python-migration","route":"/docs/manage/migrate/python-migration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:1:frontMatter","title":"Migrate from the Python v1 SDK","type":"doc","isUnderCurrentDocsTree":true},{"name":"workflow-migration","route":"/docs/manage/migrate/workflow-migration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:2:frontMatter","title":"Migrate to Speakeasy workflows","type":"doc","isUnderCurrentDocsTree":true}],"title":"Migrate","type":"doc","isUnderCurrentDocsTree":true},{"name":"forward-compatibility","route":"/docs/manage/forward-compatibility","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:5:frontMatter","title":"Forward Compatibility","type":"doc","isUnderCurrentDocsTree":true},{"name":"breaking-changes","route":"/docs/manage/breaking-changes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:6:frontMatter","title":"Handle Breaking Changes","type":"doc","isUnderCurrentDocsTree":true}],"title":"Manage","type":"doc","isUnderCurrentDocsTree":true},{"name":"publish-sdk","route":"/docs/publish-sdk","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:10:frontMatter","title":"Publish SDK","type":"doc","isUnderCurrentDocsTree":true},{"name":"languages","route":"/docs/languages","children":[{"name":"philosophy","route":"/docs/languages/philosophy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:1:frontMatter","title":"Design philosophy","type":"doc","isUnderCurrentDocsTree":true},{"name":"maturity","route":"/docs/languages/maturity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:2:frontMatter","title":"Maturity","type":"doc","isUnderCurrentDocsTree":true},{"name":"typescript","route":"/docs/languages/typescript","children":[{"name":"methodology-ts","route":"/docs/languages/typescript/methodology-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:1:frontMatter","title":"TypeScript design","type":"doc","isUnderCurrentDocsTree":true},{"name":"oss-comparison-ts","route":"/docs/languages/typescript/oss-comparison-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":true},{"name":"migrating-from-oss","route":"/docs/languages/typescript/migrating-from-oss","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:3:frontMatter","title":"Migrating from OpenAPI Generator to Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"feature-support","route":"/docs/languages/typescript/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:4:frontMatter","title":"Feature reference","type":"doc","isUnderCurrentDocsTree":true},{"name":"standalone-functions","route":"/docs/languages/typescript/standalone-functions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:5:frontMatter","title":"Standalone functions","type":"doc","isUnderCurrentDocsTree":true}],"title":"TypeScript","type":"doc","isUnderCurrentDocsTree":true},{"name":"python","route":"/docs/languages/python","children":[{"name":"methodology-python","route":"/docs/languages/python/methodology-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:1:frontMatter","title":"Python design","type":"doc","isUnderCurrentDocsTree":true},{"name":"oss-comparison-python","route":"/docs/languages/python/oss-comparison-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":true},{"name":"feature-support","route":"/docs/languages/python/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:3:frontMatter","title":"Feature reference","type":"doc","isUnderCurrentDocsTree":true}],"title":"Python","type":"doc","isUnderCurrentDocsTree":true},{"name":"golang","route":"/docs/languages/golang","children":[{"name":"methodology-go","route":"/docs/languages/golang/methodology-go","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:1:frontMatter","title":"Go design","type":"doc","isUnderCurrentDocsTree":true},{"name":"oss-comparison-go","route":"/docs/languages/golang/oss-comparison-go","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":true},{"name":"feature-support","route":"/docs/languages/golang/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:3:frontMatter","title":"Feature reference","type":"doc","isUnderCurrentDocsTree":true}],"title":"Go","type":"doc","isUnderCurrentDocsTree":true},{"name":"java","route":"/docs/languages/java","children":[{"name":"methodology-java","route":"/docs/languages/java/methodology-java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:1:frontMatter","title":"Java design","type":"doc","isUnderCurrentDocsTree":true},{"name":"oss-comparison-java","route":"/docs/languages/java/oss-comparison-java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":true},{"name":"feature-support","route":"/docs/languages/java/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:3:frontMatter","title":"Feature reference","type":"doc","isUnderCurrentDocsTree":true},{"name":"param-encoding","route":"/docs/languages/java/param-encoding","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:4:frontMatter","title":"Parameter encoding","type":"doc","isUnderCurrentDocsTree":true}],"title":"Java","type":"doc","isUnderCurrentDocsTree":true},{"name":"csharp","route":"/docs/languages/csharp","children":[{"name":"methodology-csharp","route":"/docs/languages/csharp/methodology-csharp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:7:children:1:frontMatter","title":"C# design","type":"doc","isUnderCurrentDocsTree":true},{"name":"oss-comparison-csharp","route":"/docs/languages/csharp/oss-comparison-csharp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:7:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":true}],"title":"C#","type":"doc","isUnderCurrentDocsTree":true},{"name":"php","route":"/docs/languages/php","children":[{"name":"methodology-php","route":"/docs/languages/php/methodology-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:8:children:1:frontMatter","title":"PHP design","type":"doc","isUnderCurrentDocsTree":true},{"name":"oss-comparison-php","route":"/docs/languages/php/oss-comparison-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:8:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":true}],"title":"PHP","type":"doc","isUnderCurrentDocsTree":true},{"name":"ruby","route":"/docs/languages/ruby","children":[{"name":"methodology-ruby","route":"/docs/languages/ruby/methodology-ruby","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:9:children:1:frontMatter","title":"Ruby design [coming soon]","type":"doc","isUnderCurrentDocsTree":true}],"title":"Ruby [alpha]","type":"doc","isUnderCurrentDocsTree":true},{"name":"rust","route":"/docs/languages/rust","children":[{"name":"methodology-rust","route":"/docs/languages/rust/methodology-rust","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:10:children:1:frontMatter","title":"Rust design [coming soon]","type":"doc","isUnderCurrentDocsTree":true}],"title":"Rust [coming]","type":"doc","isUnderCurrentDocsTree":true},{"name":"cpp","route":"/docs/languages/cpp","children":[{"name":"methodology-cpp","route":"/docs/languages/cpp/methodology-cpp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:11:children:1:frontMatter","title":"C++ design [coming soon]","type":"doc","isUnderCurrentDocsTree":true}],"title":"C++ [coming]","type":"doc","isUnderCurrentDocsTree":true},{"name":"unity","route":"/docs/languages/unity","children":[{"name":"methodology-unity","route":"/docs/languages/unity/methodology-unity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:12:children:1:frontMatter","title":"Unity design [coming soon]","type":"doc","isUnderCurrentDocsTree":true}],"title":"Unity [beta]","type":"doc","isUnderCurrentDocsTree":true},{"name":"swift","route":"/docs/languages/swift","children":[{"name":"methodology-swift","route":"/docs/languages/swift/methodology-swift","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:13:children:0:frontMatter","title":"Create Swift SDKs from OpenAPI / Swagger","type":"doc","isUnderCurrentDocsTree":true}],"title":"Swift","type":"doc","isUnderCurrentDocsTree":true}],"title":"Language Design","type":"doc","isUnderCurrentDocsTree":true},{"name":"agent-tools-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:agent-tools-section:title","isUnderCurrentDocsTree":true},{"name":"model-context-protocol","route":"/docs/model-context-protocol","children":[{"name":"custom-mcp-tools-resources","route":"/docs/model-context-protocol/custom-mcp-tools-resources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:13:children:0:frontMatter","title":"Custom MCP Server Extensions","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:13:frontMatter","title":"Generate MCP servers","type":"doc","isUnderCurrentDocsTree":true},{"name":"terraform-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:terraform-section:title","isUnderCurrentDocsTree":true},{"name":"create-terraform","route":"/docs/create-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:15:frontMatter","title":"Generate Terraform Provider","type":"doc","isUnderCurrentDocsTree":true},{"name":"publish-terraform","route":"/docs/publish-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:16:frontMatter","title":"Publish Terraform Provider","type":"doc","isUnderCurrentDocsTree":true},{"name":"terraform","route":"/docs/terraform","children":[{"name":"index","route":"/docs/terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:1:frontMatter","title":"Overview","type":"doc","isUnderCurrentDocsTree":true},{"name":"entity-mapping","route":"/docs/terraform/entity-mapping","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:2:frontMatter","title":"Map API Entities","type":"doc","isUnderCurrentDocsTree":true},{"name":"provider-configuration","route":"/docs/terraform/provider-configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:3:frontMatter","title":"Provider Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"resource-configuration","route":"/docs/terraform/resource-configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:4:frontMatter","title":"Resource Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"property-customization","route":"/docs/terraform/property-customization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:5:frontMatter","title":"Property Customization","type":"doc","isUnderCurrentDocsTree":true},{"name":"validation-dependencies","route":"/docs/terraform/validation-dependencies","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:6:frontMatter","title":"Validation and Dependencies","type":"doc","isUnderCurrentDocsTree":true},{"name":"plan-modification","route":"/docs/terraform/plan-modification","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:7:frontMatter","title":"Plan Modification","type":"doc","isUnderCurrentDocsTree":true},{"name":"advanced-features","route":"/docs/terraform/advanced-features","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:8:frontMatter","title":"Advanced Features","type":"doc","isUnderCurrentDocsTree":true},{"name":"schema-keywords","route":"/docs/terraform/schema-keywords","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:9:frontMatter","title":"Schema Keywords","type":"doc","isUnderCurrentDocsTree":true}],"title":"Customize Terraform","type":"doc","isUnderCurrentDocsTree":true},{"name":"testing-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:testing-section:title","isUnderCurrentDocsTree":true},{"name":"testing","route":"/docs/testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:19:frontMatter","title":"Start Testing","type":"doc","isUnderCurrentDocsTree":true},{"name":"customize-testing","route":"/docs/customize-testing","children":[{"name":"bootstrapping-test-generation","route":"/docs/customize-testing/bootstrapping-test-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:0:frontMatter","title":"Bootstrapping SDK Tests","type":"doc","isUnderCurrentDocsTree":true},{"name":"customizing-sdk-tests","route":"/docs/customize-testing/customizing-sdk-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:1:frontMatter","title":"Customizing SDK Tests","type":"doc","isUnderCurrentDocsTree":true},{"name":"github-actions","route":"/docs/customize-testing/github-actions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:2:frontMatter","title":"Testing in GitHub Actions","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-in-tests","route":"/docs/customize-testing/openapi-in-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:3:frontMatter","title":"OpenAPI Data in Tests","type":"doc","isUnderCurrentDocsTree":true},{"name":"running-tests","route":"/docs/customize-testing/running-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:4:frontMatter","title":"Running SDK Tests","type":"doc","isUnderCurrentDocsTree":true}],"title":"SDK Testing","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-contract-tests","route":"/docs/api-contract-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:21:frontMatter","title":"Configure Custom API Contract Tests","type":"doc","isUnderCurrentDocsTree":true},{"name":"docs-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:docs-section:title","isUnderCurrentDocsTree":true},{"name":"sdk-docs","route":"/docs/sdk-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:23:frontMatter","title":"Customize SDK Documentation","type":"doc","isUnderCurrentDocsTree":true},{"name":"code-samples","route":"/docs/code-samples","children":[{"name":"automated-code-sample-urls","route":"/docs/code-samples/automated-code-sample-urls","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:0:frontMatter","title":"Automated code sample URLs","type":"doc","isUnderCurrentDocsTree":true},{"name":"code-samples-api","route":"/docs/code-samples/code-samples-api","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:1:frontMatter","title":"The Code Samples API","type":"doc","isUnderCurrentDocsTree":true},{"name":"generate-code-samples","route":"/docs/code-samples/generate-code-samples","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:2:frontMatter","title":"Generating code samples for your SDK","type":"doc","isUnderCurrentDocsTree":true}],"title":"Code Samples","type":"doc","isUnderCurrentDocsTree":true},{"name":"integrations","route":"/docs/integrations","children":[{"name":"_get-public-url-snippet","route":"/docs/integrations/_get-public-url-snippet","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:0:frontMatter","title":" Get Public URL Snippet","type":"doc","isUnderCurrentDocsTree":true},{"name":"bump","route":"/docs/integrations/bump","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:1:frontMatter","title":"Integrate Speakeasy with Bump.sh","type":"doc","isUnderCurrentDocsTree":true},{"name":"mintlify","route":"/docs/integrations/mintlify","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:2:frontMatter","title":"Integrate Speakeasy with Mintlify","type":"doc","isUnderCurrentDocsTree":true},{"name":"readme","route":"/docs/integrations/readme","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:3:frontMatter","title":"Integrate Speakeasy with ReadMe","type":"doc","isUnderCurrentDocsTree":true},{"name":"scalar","route":"/docs/integrations/scalar","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:4:frontMatter","title":"Integrate Speakeasy with Scalar","type":"doc","isUnderCurrentDocsTree":true}],"title":"Integrations","type":"doc","isUnderCurrentDocsTree":true},{"name":"snippet-ai","route":"/docs/snippet-ai","children":[{"name":"overview","route":"/docs/snippet-ai/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:1:frontMatter","title":"Overview","type":"doc","isUnderCurrentDocsTree":true},{"name":"integrate-via-react","route":"/docs/snippet-ai/integrate-via-react","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:2:frontMatter","title":"Integrate via React","type":"doc","isUnderCurrentDocsTree":true},{"name":"integrate-via-web-component","route":"/docs/snippet-ai/integrate-via-web-component","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:3:frontMatter","title":"Integrate via Web Component","type":"doc","isUnderCurrentDocsTree":true},{"name":"integrate-via-script","route":"/docs/snippet-ai/integrate-via-script","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:4:frontMatter","title":"Integrate via Script","type":"doc","isUnderCurrentDocsTree":true}],"title":"SnippetAI","type":"doc","isUnderCurrentDocsTree":true},{"name":"reference-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:reference-section:title","isUnderCurrentDocsTree":true},{"name":"speakeasy-reference","route":"/docs/speakeasy-reference","children":[{"name":"cli","route":"/docs/speakeasy-reference/cli","children":[{"name":"getting-started","route":"/docs/speakeasy-reference/cli/getting-started","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:1:frontMatter","title":"Getting Started","type":"doc","isUnderCurrentDocsTree":true},{"name":"mise-toolkit","route":"/docs/speakeasy-reference/cli/mise-toolkit","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:2:frontMatter","title":"Using with mise toolkit","type":"doc","isUnderCurrentDocsTree":true},{"name":"ask","route":"/docs/speakeasy-reference/cli/ask","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:3:frontMatter","title":"ask","type":"doc","isUnderCurrentDocsTree":true},{"name":"auth","route":"/docs/speakeasy-reference/cli/auth","children":[{"name":"login","route":"/docs/speakeasy-reference/cli/auth/login","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:4:children:0:frontMatter","title":"login","type":"doc","isUnderCurrentDocsTree":true},{"name":"logout","route":"/docs/speakeasy-reference/cli/auth/logout","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:4:children:1:frontMatter","title":"logout","type":"doc","isUnderCurrentDocsTree":true},{"name":"switch","route":"/docs/speakeasy-reference/cli/auth/switch","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:4:children:2:frontMatter","title":"switch","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:4:frontMatter","title":"auth","type":"doc","isUnderCurrentDocsTree":true},{"name":"billing","route":"/docs/speakeasy-reference/cli/billing","children":[{"name":"activate","route":"/docs/speakeasy-reference/cli/billing/activate","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:5:children:0:frontMatter","title":"activate","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:5:frontMatter","title":"billing","type":"doc","isUnderCurrentDocsTree":true},{"name":"bump","route":"/docs/speakeasy-reference/cli/bump","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:6:frontMatter","title":"bump","type":"doc","isUnderCurrentDocsTree":true},{"name":"clean","route":"/docs/speakeasy-reference/cli/clean","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:7:frontMatter","title":"clean","type":"doc","isUnderCurrentDocsTree":true},{"name":"configure","route":"/docs/speakeasy-reference/cli/configure","children":[{"name":"github","route":"/docs/speakeasy-reference/cli/configure/github","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:0:frontMatter","title":"github","type":"doc","isUnderCurrentDocsTree":true},{"name":"publishing","route":"/docs/speakeasy-reference/cli/configure/publishing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:1:frontMatter","title":"publishing","type":"doc","isUnderCurrentDocsTree":true},{"name":"sources","route":"/docs/speakeasy-reference/cli/configure/sources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:2:frontMatter","title":"sources","type":"doc","isUnderCurrentDocsTree":true},{"name":"targets","route":"/docs/speakeasy-reference/cli/configure/targets","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:3:frontMatter","title":"targets","type":"doc","isUnderCurrentDocsTree":true},{"name":"tests","route":"/docs/speakeasy-reference/cli/configure/tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:4:frontMatter","title":"tests","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:frontMatter","title":"configure","type":"doc","isUnderCurrentDocsTree":true},{"name":"lint","route":"/docs/speakeasy-reference/cli/lint","children":[{"name":"arazzo","route":"/docs/speakeasy-reference/cli/lint/arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:9:children:0:frontMatter","title":"arazzo","type":"doc","isUnderCurrentDocsTree":true},{"name":"config","route":"/docs/speakeasy-reference/cli/lint/config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:9:children:1:frontMatter","title":"config","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi","route":"/docs/speakeasy-reference/cli/lint/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:9:children:2:frontMatter","title":"openapi","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:9:frontMatter","title":"lint","type":"doc","isUnderCurrentDocsTree":true},{"name":"merge","route":"/docs/speakeasy-reference/cli/merge","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:10:frontMatter","title":"merge","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi","route":"/docs/speakeasy-reference/cli/openapi","children":[{"name":"diff","route":"/docs/speakeasy-reference/cli/openapi/diff","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:0:frontMatter","title":"diff","type":"doc","isUnderCurrentDocsTree":true},{"name":"lint","route":"/docs/speakeasy-reference/cli/openapi/lint","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:1:frontMatter","title":"lint","type":"doc","isUnderCurrentDocsTree":true},{"name":"transform","route":"/docs/speakeasy-reference/cli/openapi/transform","children":[{"name":"cleanup","route":"/docs/speakeasy-reference/cli/openapi/transform/cleanup","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:0:frontMatter","title":"cleanup","type":"doc","isUnderCurrentDocsTree":true},{"name":"convert-swagger","route":"/docs/speakeasy-reference/cli/openapi/transform/convert-swagger","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:1:frontMatter","title":"convert-swagger","type":"doc","isUnderCurrentDocsTree":true},{"name":"filter-operations","route":"/docs/speakeasy-reference/cli/openapi/transform/filter-operations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:2:frontMatter","title":"filter-operations","type":"doc","isUnderCurrentDocsTree":true},{"name":"format","route":"/docs/speakeasy-reference/cli/openapi/transform/format","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:3:frontMatter","title":"format","type":"doc","isUnderCurrentDocsTree":true},{"name":"normalize","route":"/docs/speakeasy-reference/cli/openapi/transform/normalize","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:4:frontMatter","title":"normalize","type":"doc","isUnderCurrentDocsTree":true},{"name":"remove-unused","route":"/docs/speakeasy-reference/cli/openapi/transform/remove-unused","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:5:frontMatter","title":"remove-unused","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:frontMatter","title":"transform","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:frontMatter","title":"openapi","type":"doc","isUnderCurrentDocsTree":true},{"name":"overlay","route":"/docs/speakeasy-reference/cli/overlay","children":[{"name":"apply","route":"/docs/speakeasy-reference/cli/overlay/apply","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:12:children:0:frontMatter","title":"apply","type":"doc","isUnderCurrentDocsTree":true},{"name":"compare","route":"/docs/speakeasy-reference/cli/overlay/compare","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:12:children:1:frontMatter","title":"compare","type":"doc","isUnderCurrentDocsTree":true},{"name":"validate","route":"/docs/speakeasy-reference/cli/overlay/validate","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:12:children:2:frontMatter","title":"validate","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:12:frontMatter","title":"overlay","type":"doc","isUnderCurrentDocsTree":true},{"name":"quickstart","route":"/docs/speakeasy-reference/cli/quickstart","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:13:frontMatter","title":"quickstart","type":"doc","isUnderCurrentDocsTree":true},{"name":"run","route":"/docs/speakeasy-reference/cli/run","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:14:frontMatter","title":"run","type":"doc","isUnderCurrentDocsTree":true},{"name":"status","route":"/docs/speakeasy-reference/cli/status","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:15:frontMatter","title":"status","type":"doc","isUnderCurrentDocsTree":true},{"name":"suggest","route":"/docs/speakeasy-reference/cli/suggest","children":[{"name":"error-types","route":"/docs/speakeasy-reference/cli/suggest/error-types","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:16:children:0:frontMatter","title":"error-types","type":"doc","isUnderCurrentDocsTree":true},{"name":"operation-ids","route":"/docs/speakeasy-reference/cli/suggest/operation-ids","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:16:children:1:frontMatter","title":"operation-ids","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:16:frontMatter","title":"suggest","type":"doc","isUnderCurrentDocsTree":true},{"name":"tag","route":"/docs/speakeasy-reference/cli/tag","children":[{"name":"apply","route":"/docs/speakeasy-reference/cli/tag/apply","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:17:children:0:frontMatter","title":"apply","type":"doc","isUnderCurrentDocsTree":true},{"name":"promote","route":"/docs/speakeasy-reference/cli/tag/promote","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:17:children:1:frontMatter","title":"promote","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:17:frontMatter","title":"tag","type":"doc","isUnderCurrentDocsTree":true},{"name":"test","route":"/docs/speakeasy-reference/cli/test","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:18:frontMatter","title":"test","type":"doc","isUnderCurrentDocsTree":true},{"name":"update","route":"/docs/speakeasy-reference/cli/update","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:19:frontMatter","title":"update","type":"doc","isUnderCurrentDocsTree":true}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:frontMatter","title":"CLI","type":"doc","isUnderCurrentDocsTree":true},{"name":"generation","route":"/docs/speakeasy-reference/generation","children":[{"name":"gen-yaml","route":"/docs/speakeasy-reference/generation/gen-yaml","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:1:frontMatter","title":"Config File","type":"doc","isUnderCurrentDocsTree":true},{"name":"ci-cd-pipeline","route":"/docs/speakeasy-reference/generation/ci-cd-pipeline","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:2:frontMatter","title":"CI/CD Pipeline","type":"doc","isUnderCurrentDocsTree":true},{"name":"ts-config","route":"/docs/speakeasy-reference/generation/ts-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:3:frontMatter","title":"TypeScript Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"python-config","route":"/docs/speakeasy-reference/generation/python-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:4:frontMatter","title":"Python Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"go-config","route":"/docs/speakeasy-reference/generation/go-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:5:frontMatter","title":"Go Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"java-config","route":"/docs/speakeasy-reference/generation/java-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:6:frontMatter","title":"Java Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"csharp-config","route":"/docs/speakeasy-reference/generation/csharp-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:7:frontMatter","title":"C# Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"php-config","route":"/docs/speakeasy-reference/generation/php-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:8:frontMatter","title":"PHP Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"ruby-config","route":"/docs/speakeasy-reference/generation/ruby-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:9:frontMatter","title":"Ruby Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"swift-config","route":"/docs/speakeasy-reference/generation/swift-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:10:frontMatter","title":"Swift Configuration","type":"doc","isUnderCurrentDocsTree":true},{"name":"terraform-config","route":"/docs/speakeasy-reference/generation/terraform-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:11:frontMatter","title":"Terraform Configuration","type":"doc","isUnderCurrentDocsTree":true}],"title":"Generation Config","type":"doc","isUnderCurrentDocsTree":true},{"name":"extensions","route":"/docs/speakeasy-reference/extensions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:3:frontMatter","title":"Speakeasy extensions","type":"doc","isUnderCurrentDocsTree":true},{"name":"workflow-file","route":"/docs/speakeasy-reference/workflow-file","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:4:frontMatter","title":"Speakeasy Workflow File","type":"doc","isUnderCurrentDocsTree":true}],"title":"Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"supported","route":"/docs/supported","children":[{"name":"openapi","route":"/docs/supported/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:30:children:0:frontMatter","title":"OpenAPI Support Matrix","type":"doc","isUnderCurrentDocsTree":true},{"name":"terraform","route":"/docs/supported/terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:30:children:1:frontMatter","title":"Speakeasy Terraform provider support matrix","type":"doc","isUnderCurrentDocsTree":true}],"title":"Supported","type":"doc","isUnderCurrentDocsTree":true},{"name":"support-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:support-section:title","isUnderCurrentDocsTree":true},{"name":"slack-community","href":"https://go.speakeasy.com/slack","title":"Slack Community","type":"doc","isUnderCurrentDocsTree":true},{"name":"enterprise-support","route":"/docs/enterprise-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:33:frontMatter","title":"Enterprise Support","type":"doc","isUnderCurrentDocsTree":true},{"name":"privacy-security-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:privacy-security-section:title","isUnderCurrentDocsTree":true},{"name":"product-security","route":"/docs/product-security","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:35:frontMatter","title":"Product Security","type":"doc","isUnderCurrentDocsTree":true},{"name":"privacy-policy","route":"/docs/privacy-policy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:36:frontMatter","title":"Privacy Policy","type":"doc","isUnderCurrentDocsTree":true},{"name":"terms-of-service","route":"/docs/terms-of-service","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:37:frontMatter","title":"Terms of Service","type":"doc","isUnderCurrentDocsTree":true},{"name":"guides","route":"/docs/guides","children":[{"name":"code-samples-without-github-actions","route":"/docs/guides/code-samples-without-github-actions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:38:children:0:frontMatter","title":"Using the CLI to populate code samples without GitHub Actions","type":"doc","isUnderCurrentDocsTree":true}],"title":"Guides","type":"doc","isUnderCurrentDocsTree":true}],"activePath":[{"name":"docs","route":"/docs","children":["$5:0:props:menuData:0",{"name":"index","route":"/docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:2:frontMatter","title":"Home","type":"doc"},{"name":"introduction","route":"/docs/introduction","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:3:frontMatter","title":"Introduction","type":"doc"},{"name":"core-concepts","route":"/docs/core-concepts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:4:frontMatter","title":"Core Concepts","type":"doc"},"$5:0:props:menuData:4",{"name":"create-client-sdks","route":"/docs/create-client-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:6:frontMatter","title":"Generate SDKs","type":"doc"},{"name":"prep-openapi","route":"/docs/prep-openapi","children":[{"name":"best-practices","route":"/docs/prep-openapi/best-practices","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:0:frontMatter","title":"OpenAPI overview and best practices","type":"doc"},{"name":"linting","route":"/docs/prep-openapi/linting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:1:frontMatter","title":"OpenAPI document linting","type":"doc"},{"name":"maintenance","route":"/docs/prep-openapi/maintenance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:2:frontMatter","title":"Speakeasy Suggest","type":"doc"},{"name":"overlays","route":"/docs/prep-openapi/overlays","children":[{"name":"apply-overlays","route":"/docs/prep-openapi/overlays/apply-overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:3:children:0:frontMatter","title":"Apply an overlay","type":"doc"},{"name":"create-overlays","route":"/docs/prep-openapi/overlays/create-overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:3:children:1:frontMatter","title":"Create overlays","type":"doc"}],"title":"Overlays","type":"doc"},{"name":"transformations","route":"/docs/prep-openapi/transformations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:4:frontMatter","title":"Transformations","type":"doc"}],"title":"Prepare OpenAPI Spec","type":"doc"},{"name":"customize","route":"/docs/customize","children":[{"name":"basics","route":"/docs/customize/basics","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:1:frontMatter","title":"Customization Basics","type":"doc"},{"name":"structure","route":"/docs/customize/structure","children":[{"name":"imports","route":"/docs/customize/structure/imports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:2:children:0:frontMatter","title":"Customize imports","type":"doc"},{"name":"namespaces","route":"/docs/customize/structure/namespaces","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:2:children:1:frontMatter","title":"Customize namespaces","type":"doc"}],"title":"Structure","type":"doc"},{"name":"data-model","route":"/docs/customize/data-model","children":[{"name":"types","route":"/docs/customize/data-model/types","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:1:frontMatter","title":"Types","type":"doc"},{"name":"enums","route":"/docs/customize/data-model/enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:2:frontMatter","title":"Enums","type":"doc"},{"name":"oneof-schemas","route":"/docs/customize/data-model/oneof-schemas","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:3:frontMatter","title":"OneOf","type":"doc"},{"name":"complex-numbers","route":"/docs/customize/data-model/complex-numbers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:4:frontMatter","title":"Complex Numbers","type":"doc"}],"title":"Data Model","type":"doc"},{"name":"methods","route":"/docs/customize/methods","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:4:frontMatter","title":"Customize methods","type":"doc"},{"name":"responses","route":"/docs/customize/responses","children":[{"name":"responses","route":"/docs/customize/responses/responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:5:children:1:frontMatter","title":"Customize Responses","type":"doc"},{"name":"errors","route":"/docs/customize/responses/errors","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:5:children:2:frontMatter","title":"Error Handling","type":"doc"}],"title":"Responses & Error Handling","type":"doc"},{"name":"globals","route":"/docs/customize/globals","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:6:frontMatter","title":"Global Parameters","type":"doc"},{"name":"servers","route":"/docs/customize/servers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:7:frontMatter","title":"Configure servers","type":"doc"},{"name":"deprecations","route":"/docs/customize/deprecations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:8:frontMatter","title":"Deprecations","type":"doc"},{"name":"authentication","route":"/docs/customize/authentication","children":[{"name":"overview","route":"/docs/customize/authentication/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:1:frontMatter","title":"Overview","type":"doc"},{"name":"configuration","route":"/docs/customize/authentication/configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:2:frontMatter","title":"Configuration Options","type":"doc"},{"name":"simple-schemes","route":"/docs/customize/authentication/simple-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:3:frontMatter","title":"Standard security schemes","type":"doc"},{"name":"oauth","route":"/docs/customize/authentication/oauth","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:4:frontMatter","title":"OAuth 2.0 Authentication","type":"doc"},{"name":"custom-security-schemes","route":"/docs/customize/authentication/custom-security-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:5:frontMatter","title":"Custom Security Schemes","type":"doc"},{"name":"security-callbacks","route":"/docs/customize/authentication/security-callbacks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:6:frontMatter","title":"Security Callbacks","type":"doc"}],"title":"Security & Authentication","type":"doc"},{"name":"runtime","route":"/docs/customize/runtime","children":[{"name":"retries","route":"/docs/customize/runtime/retries","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:1:frontMatter","title":"Enable Retries","type":"doc"},{"name":"timeouts","route":"/docs/customize/runtime/timeouts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:2:frontMatter","title":"Enable Timeouts","type":"doc"},{"name":"pagination","route":"/docs/customize/runtime/pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:3:frontMatter","title":"Enable Pagination","type":"doc"},{"name":"streaming","route":"/docs/customize/runtime/streaming","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:4:frontMatter","title":"Enable Streaming","type":"doc"},{"name":"server-sent-events","route":"/docs/customize/runtime/server-sent-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:5:frontMatter","title":"Enable Server-Sent Events","type":"doc"},{"name":"jsonl-events","route":"/docs/customize/runtime/jsonl-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:6:frontMatter","title":"Enable JSON Lines Responses","type":"doc"},{"name":"custom-http-client","route":"/docs/customize/runtime/custom-http-client","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:7:frontMatter","title":"Customize HTTP Client","type":"doc"},{"name":"override-accept-headers","route":"/docs/customize/runtime/override-accept-headers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:8:frontMatter","title":"Override accept headers","type":"doc"}],"title":"SDK Behavior","type":"doc"},{"name":"webhooks","route":"/docs/customize/webhooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:11:frontMatter","title":"Add webhooks to your SDKs","type":"doc"},{"name":"code","route":"/docs/customize/code","children":[{"name":"code-regions","route":"/docs/customize/code/code-regions","children":[{"name":"overview","route":"/docs/customize/code/code-regions/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:1:frontMatter","title":"Custom code regions","type":"doc"},{"name":"python","route":"/docs/customize/code/code-regions/python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:2:frontMatter","title":"Custom code regions in Python","type":"doc"},{"name":"typescript","route":"/docs/customize/code/code-regions/typescript","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:3:frontMatter","title":"Custom code regions in TypeScript","type":"doc"},{"name":"java","route":"/docs/customize/code/code-regions/java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:4:frontMatter","title":"Custom code regions in Java","type":"doc"}],"title":"Code Regions","type":"doc"},{"name":"monkey-patching","route":"/docs/customize/code/monkey-patching","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:2:frontMatter","title":"Monkey patching","type":"doc"},{"name":"sdk-hooks","route":"/docs/customize/code/sdk-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:3:frontMatter","title":"Custom code with SDK hooks","type":"doc"}],"title":"Add Custom Code","type":"doc"},{"name":"typescript","route":"/docs/customize/typescript","children":[{"name":"additional-index-exports","route":"/docs/customize/typescript/additional-index-exports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:0:frontMatter","title":"Additional index exports","type":"doc"},{"name":"configuring-module-format","route":"/docs/customize/typescript/configuring-module-format","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:1:frontMatter","title":"Configuring module format","type":"doc"},{"name":"disabling-barrel-files","route":"/docs/customize/typescript/disabling-barrel-files","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:2:frontMatter","title":"Disabling barrel files","type":"doc"},{"name":"model-validation-and-serialization","route":"/docs/customize/typescript/model-validation-and-serialization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:3:frontMatter","title":"Model validation and serialization","type":"doc"},{"name":"react-hooks","route":"/docs/customize/typescript/react-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:4:frontMatter","title":"Generating React Hooks from OpenAPI/Swagger","type":"doc"}],"title":"TypeScript","type":"doc"}],"title":"Customize","type":"doc"},{"name":"manage","route":"/docs/manage","children":[{"name":"versioning","route":"/docs/manage/versioning","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:1:frontMatter","title":"Version Control","type":"doc"},{"name":"github-setup","route":"/docs/manage/github-setup","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:2:frontMatter","title":"Github Setup","type":"doc"},{"name":"sdk-sandbox","route":"/docs/manage/sdk-sandbox","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:3:frontMatter","title":"Enable Sandbox","type":"doc"},{"name":"migrate","route":"/docs/manage/migrate","children":[{"name":"poetry-2-update","route":"/docs/manage/migrate/poetry-2-update","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:0:frontMatter","title":"Poetry 2.0 and Python 3.9 Updates","type":"doc"},{"name":"python-migration","route":"/docs/manage/migrate/python-migration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:1:frontMatter","title":"Migrate from the Python v1 SDK","type":"doc"},{"name":"workflow-migration","route":"/docs/manage/migrate/workflow-migration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:2:frontMatter","title":"Migrate to Speakeasy workflows","type":"doc"}],"title":"Migrate","type":"doc"},{"name":"forward-compatibility","route":"/docs/manage/forward-compatibility","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:5:frontMatter","title":"Forward Compatibility","type":"doc"},{"name":"breaking-changes","route":"/docs/manage/breaking-changes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:6:frontMatter","title":"Handle Breaking Changes","type":"doc"}],"title":"Manage","type":"doc"},{"name":"publish-sdk","route":"/docs/publish-sdk","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:10:frontMatter","title":"Publish SDK","type":"doc"},{"name":"languages","route":"/docs/languages","children":[{"name":"philosophy","route":"/docs/languages/philosophy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:1:frontMatter","title":"Design philosophy","type":"doc"},{"name":"maturity","route":"/docs/languages/maturity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:2:frontMatter","title":"Maturity","type":"doc"},{"name":"typescript","route":"/docs/languages/typescript","children":[{"name":"methodology-ts","route":"/docs/languages/typescript/methodology-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:1:frontMatter","title":"TypeScript design","type":"doc"},{"name":"oss-comparison-ts","route":"/docs/languages/typescript/oss-comparison-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"},{"name":"migrating-from-oss","route":"/docs/languages/typescript/migrating-from-oss","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:3:frontMatter","title":"Migrating from OpenAPI Generator to Speakeasy","type":"doc"},{"name":"feature-support","route":"/docs/languages/typescript/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:4:frontMatter","title":"Feature reference","type":"doc"},{"name":"standalone-functions","route":"/docs/languages/typescript/standalone-functions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:5:frontMatter","title":"Standalone functions","type":"doc"}],"title":"TypeScript","type":"doc"},{"name":"python","route":"/docs/languages/python","children":[{"name":"methodology-python","route":"/docs/languages/python/methodology-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:1:frontMatter","title":"Python design","type":"doc"},{"name":"oss-comparison-python","route":"/docs/languages/python/oss-comparison-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"},{"name":"feature-support","route":"/docs/languages/python/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:3:frontMatter","title":"Feature reference","type":"doc"}],"title":"Python","type":"doc"},{"name":"golang","route":"/docs/languages/golang","children":[{"name":"methodology-go","route":"/docs/languages/golang/methodology-go","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:1:frontMatter","title":"Go design","type":"doc"},{"name":"oss-comparison-go","route":"/docs/languages/golang/oss-comparison-go","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"},{"name":"feature-support","route":"/docs/languages/golang/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:3:frontMatter","title":"Feature reference","type":"doc"}],"title":"Go","type":"doc"},{"name":"java","route":"/docs/languages/java","children":[{"name":"methodology-java","route":"/docs/languages/java/methodology-java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:1:frontMatter","title":"Java design","type":"doc"},{"name":"oss-comparison-java","route":"/docs/languages/java/oss-comparison-java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"},{"name":"feature-support","route":"/docs/languages/java/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:3:frontMatter","title":"Feature reference","type":"doc"},{"name":"param-encoding","route":"/docs/languages/java/param-encoding","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:4:frontMatter","title":"Parameter encoding","type":"doc"}],"title":"Java","type":"doc"},{"name":"csharp","route":"/docs/languages/csharp","children":[{"name":"methodology-csharp","route":"/docs/languages/csharp/methodology-csharp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:7:children:1:frontMatter","title":"C# design","type":"doc"},{"name":"oss-comparison-csharp","route":"/docs/languages/csharp/oss-comparison-csharp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:7:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"}],"title":"C#","type":"doc"},{"name":"php","route":"/docs/languages/php","children":[{"name":"methodology-php","route":"/docs/languages/php/methodology-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:8:children:1:frontMatter","title":"PHP design","type":"doc"},{"name":"oss-comparison-php","route":"/docs/languages/php/oss-comparison-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:8:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"}],"title":"PHP","type":"doc"},{"name":"ruby","route":"/docs/languages/ruby","children":[{"name":"methodology-ruby","route":"/docs/languages/ruby/methodology-ruby","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:9:children:1:frontMatter","title":"Ruby design [coming soon]","type":"doc"}],"title":"Ruby [alpha]","type":"doc"},{"name":"rust","route":"/docs/languages/rust","children":[{"name":"methodology-rust","route":"/docs/languages/rust/methodology-rust","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:10:children:1:frontMatter","title":"Rust design [coming soon]","type":"doc"}],"title":"Rust [coming]","type":"doc"},{"name":"cpp","route":"/docs/languages/cpp","children":[{"name":"methodology-cpp","route":"/docs/languages/cpp/methodology-cpp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:11:children:1:frontMatter","title":"C++ design [coming soon]","type":"doc"}],"title":"C++ [coming]","type":"doc"},{"name":"unity","route":"/docs/languages/unity","children":[{"name":"methodology-unity","route":"/docs/languages/unity/methodology-unity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:12:children:1:frontMatter","title":"Unity design [coming soon]","type":"doc"}],"title":"Unity [beta]","type":"doc"},{"name":"swift","route":"/docs/languages/swift","children":[{"name":"methodology-swift","route":"/docs/languages/swift/methodology-swift","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:13:children:0:frontMatter","title":"Create Swift SDKs from OpenAPI / Swagger","type":"doc"}],"title":"Swift","type":"doc"}],"title":"Language Design","type":"doc"},"$5:0:props:menuData:11",{"name":"model-context-protocol","route":"/docs/model-context-protocol","children":[{"name":"custom-mcp-tools-resources","route":"/docs/model-context-protocol/custom-mcp-tools-resources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:13:children:0:frontMatter","title":"Custom MCP Server Extensions","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:13:frontMatter","title":"Generate MCP servers","type":"doc"},"$5:0:props:menuData:13",{"name":"create-terraform","route":"/docs/create-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:15:frontMatter","title":"Generate Terraform Provider","type":"doc"},{"name":"publish-terraform","route":"/docs/publish-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:16:frontMatter","title":"Publish Terraform Provider","type":"doc"},{"name":"terraform","route":"/docs/terraform","children":[{"name":"index","route":"/docs/terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:1:frontMatter","title":"Overview","type":"doc"},{"name":"entity-mapping","route":"/docs/terraform/entity-mapping","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:2:frontMatter","title":"Map API Entities","type":"doc"},{"name":"provider-configuration","route":"/docs/terraform/provider-configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:3:frontMatter","title":"Provider Configuration","type":"doc"},{"name":"resource-configuration","route":"/docs/terraform/resource-configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:4:frontMatter","title":"Resource Configuration","type":"doc"},{"name":"property-customization","route":"/docs/terraform/property-customization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:5:frontMatter","title":"Property Customization","type":"doc"},{"name":"validation-dependencies","route":"/docs/terraform/validation-dependencies","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:6:frontMatter","title":"Validation and Dependencies","type":"doc"},{"name":"plan-modification","route":"/docs/terraform/plan-modification","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:7:frontMatter","title":"Plan Modification","type":"doc"},{"name":"advanced-features","route":"/docs/terraform/advanced-features","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:8:frontMatter","title":"Advanced Features","type":"doc"},{"name":"schema-keywords","route":"/docs/terraform/schema-keywords","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:9:frontMatter","title":"Schema Keywords","type":"doc"}],"title":"Customize Terraform","type":"doc"},"$5:0:props:menuData:17",{"name":"testing","route":"/docs/testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:19:frontMatter","title":"Start Testing","type":"doc"},{"name":"customize-testing","route":"/docs/customize-testing","children":[{"name":"bootstrapping-test-generation","route":"/docs/customize-testing/bootstrapping-test-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:0:frontMatter","title":"Bootstrapping SDK Tests","type":"doc"},{"name":"customizing-sdk-tests","route":"/docs/customize-testing/customizing-sdk-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:1:frontMatter","title":"Customizing SDK Tests","type":"doc"},{"name":"github-actions","route":"/docs/customize-testing/github-actions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:2:frontMatter","title":"Testing in GitHub Actions","type":"doc"},{"name":"openapi-in-tests","route":"/docs/customize-testing/openapi-in-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:3:frontMatter","title":"OpenAPI Data in Tests","type":"doc"},{"name":"running-tests","route":"/docs/customize-testing/running-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:4:frontMatter","title":"Running SDK Tests","type":"doc"}],"title":"SDK Testing","type":"doc"},{"name":"api-contract-tests","route":"/docs/api-contract-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:21:frontMatter","title":"Configure Custom API Contract Tests","type":"doc"},"$5:0:props:menuData:21",{"name":"sdk-docs","route":"/docs/sdk-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:23:frontMatter","title":"Customize SDK Documentation","type":"doc"},{"name":"code-samples","route":"/docs/code-samples","children":[{"name":"automated-code-sample-urls","route":"/docs/code-samples/automated-code-sample-urls","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:0:frontMatter","title":"Automated code sample URLs","type":"doc"},{"name":"code-samples-api","route":"/docs/code-samples/code-samples-api","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:1:frontMatter","title":"The Code Samples API","type":"doc"},{"name":"generate-code-samples","route":"/docs/code-samples/generate-code-samples","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:2:frontMatter","title":"Generating code samples for your SDK","type":"doc"}],"title":"Code Samples","type":"doc"},{"name":"integrations","route":"/docs/integrations","children":[{"name":"_get-public-url-snippet","route":"/docs/integrations/_get-public-url-snippet","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:0:frontMatter","title":" Get Public URL Snippet","type":"doc"},{"name":"bump","route":"/docs/integrations/bump","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:1:frontMatter","title":"Integrate Speakeasy with Bump.sh","type":"doc"},{"name":"mintlify","route":"/docs/integrations/mintlify","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:2:frontMatter","title":"Integrate Speakeasy with Mintlify","type":"doc"},{"name":"readme","route":"/docs/integrations/readme","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:3:frontMatter","title":"Integrate Speakeasy with ReadMe","type":"doc"},{"name":"scalar","route":"/docs/integrations/scalar","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:4:frontMatter","title":"Integrate Speakeasy with Scalar","type":"doc"}],"title":"Integrations","type":"doc"},{"name":"snippet-ai","route":"/docs/snippet-ai","children":[{"name":"overview","route":"/docs/snippet-ai/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:1:frontMatter","title":"Overview","type":"doc"},{"name":"integrate-via-react","route":"/docs/snippet-ai/integrate-via-react","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:2:frontMatter","title":"Integrate via React","type":"doc"},{"name":"integrate-via-web-component","route":"/docs/snippet-ai/integrate-via-web-component","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:3:frontMatter","title":"Integrate via Web Component","type":"doc"},{"name":"integrate-via-script","route":"/docs/snippet-ai/integrate-via-script","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:4:frontMatter","title":"Integrate via Script","type":"doc"}],"title":"SnippetAI","type":"doc"},"$5:0:props:menuData:26",{"name":"speakeasy-reference","route":"/docs/speakeasy-reference","children":[{"name":"cli","route":"/docs/speakeasy-reference/cli","children":[{"name":"getting-started","route":"/docs/speakeasy-reference/cli/getting-started","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:1:frontMatter","title":"Getting Started","type":"doc"},{"name":"mise-toolkit","route":"/docs/speakeasy-reference/cli/mise-toolkit","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:2:frontMatter","title":"Using with mise toolkit","type":"doc"},{"name":"ask","route":"/docs/speakeasy-reference/cli/ask","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:3:frontMatter","title":"ask","type":"doc"},{"name":"auth","route":"/docs/speakeasy-reference/cli/auth","children":[{"name":"login","route":"/docs/speakeasy-reference/cli/auth/login","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:4:children:0:frontMatter","title":"login","type":"doc"},{"name":"logout","route":"/docs/speakeasy-reference/cli/auth/logout","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:4:children:1:frontMatter","title":"logout","type":"doc"},{"name":"switch","route":"/docs/speakeasy-reference/cli/auth/switch","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:4:children:2:frontMatter","title":"switch","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:4:frontMatter","title":"auth","type":"doc"},{"name":"billing","route":"/docs/speakeasy-reference/cli/billing","children":[{"name":"activate","route":"/docs/speakeasy-reference/cli/billing/activate","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:5:children:0:frontMatter","title":"activate","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:5:frontMatter","title":"billing","type":"doc"},{"name":"bump","route":"/docs/speakeasy-reference/cli/bump","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:6:frontMatter","title":"bump","type":"doc"},{"name":"clean","route":"/docs/speakeasy-reference/cli/clean","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:7:frontMatter","title":"clean","type":"doc"},{"name":"configure","route":"/docs/speakeasy-reference/cli/configure","children":[{"name":"github","route":"/docs/speakeasy-reference/cli/configure/github","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:0:frontMatter","title":"github","type":"doc"},{"name":"publishing","route":"/docs/speakeasy-reference/cli/configure/publishing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:1:frontMatter","title":"publishing","type":"doc"},{"name":"sources","route":"/docs/speakeasy-reference/cli/configure/sources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:2:frontMatter","title":"sources","type":"doc"},{"name":"targets","route":"/docs/speakeasy-reference/cli/configure/targets","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:3:frontMatter","title":"targets","type":"doc"},{"name":"tests","route":"/docs/speakeasy-reference/cli/configure/tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:children:4:frontMatter","title":"tests","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:8:frontMatter","title":"configure","type":"doc"},{"name":"lint","route":"/docs/speakeasy-reference/cli/lint","children":[{"name":"arazzo","route":"/docs/speakeasy-reference/cli/lint/arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:9:children:0:frontMatter","title":"arazzo","type":"doc"},{"name":"config","route":"/docs/speakeasy-reference/cli/lint/config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:9:children:1:frontMatter","title":"config","type":"doc"},{"name":"openapi","route":"/docs/speakeasy-reference/cli/lint/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:9:children:2:frontMatter","title":"openapi","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:9:frontMatter","title":"lint","type":"doc"},{"name":"merge","route":"/docs/speakeasy-reference/cli/merge","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:10:frontMatter","title":"merge","type":"doc"},{"name":"openapi","route":"/docs/speakeasy-reference/cli/openapi","children":[{"name":"diff","route":"/docs/speakeasy-reference/cli/openapi/diff","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:0:frontMatter","title":"diff","type":"doc"},{"name":"lint","route":"/docs/speakeasy-reference/cli/openapi/lint","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:1:frontMatter","title":"lint","type":"doc"},{"name":"transform","route":"/docs/speakeasy-reference/cli/openapi/transform","children":[{"name":"cleanup","route":"/docs/speakeasy-reference/cli/openapi/transform/cleanup","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:0:frontMatter","title":"cleanup","type":"doc"},{"name":"convert-swagger","route":"/docs/speakeasy-reference/cli/openapi/transform/convert-swagger","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:1:frontMatter","title":"convert-swagger","type":"doc"},{"name":"filter-operations","route":"/docs/speakeasy-reference/cli/openapi/transform/filter-operations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:2:frontMatter","title":"filter-operations","type":"doc"},{"name":"format","route":"/docs/speakeasy-reference/cli/openapi/transform/format","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:3:frontMatter","title":"format","type":"doc"},{"name":"normalize","route":"/docs/speakeasy-reference/cli/openapi/transform/normalize","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:4:frontMatter","title":"normalize","type":"doc"},{"name":"remove-unused","route":"/docs/speakeasy-reference/cli/openapi/transform/remove-unused","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:children:5:frontMatter","title":"remove-unused","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:children:2:frontMatter","title":"transform","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:11:frontMatter","title":"openapi","type":"doc"},{"name":"overlay","route":"/docs/speakeasy-reference/cli/overlay","children":[{"name":"apply","route":"/docs/speakeasy-reference/cli/overlay/apply","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:12:children:0:frontMatter","title":"apply","type":"doc"},{"name":"compare","route":"/docs/speakeasy-reference/cli/overlay/compare","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:12:children:1:frontMatter","title":"compare","type":"doc"},{"name":"validate","route":"/docs/speakeasy-reference/cli/overlay/validate","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:12:children:2:frontMatter","title":"validate","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:12:frontMatter","title":"overlay","type":"doc"},{"name":"quickstart","route":"/docs/speakeasy-reference/cli/quickstart","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:13:frontMatter","title":"quickstart","type":"doc"},{"name":"run","route":"/docs/speakeasy-reference/cli/run","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:14:frontMatter","title":"run","type":"doc"},{"name":"status","route":"/docs/speakeasy-reference/cli/status","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:15:frontMatter","title":"status","type":"doc"},{"name":"suggest","route":"/docs/speakeasy-reference/cli/suggest","children":[{"name":"error-types","route":"/docs/speakeasy-reference/cli/suggest/error-types","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:16:children:0:frontMatter","title":"error-types","type":"doc"},{"name":"operation-ids","route":"/docs/speakeasy-reference/cli/suggest/operation-ids","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:16:children:1:frontMatter","title":"operation-ids","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:16:frontMatter","title":"suggest","type":"doc"},{"name":"tag","route":"/docs/speakeasy-reference/cli/tag","children":[{"name":"apply","route":"/docs/speakeasy-reference/cli/tag/apply","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:17:children:0:frontMatter","title":"apply","type":"doc"},{"name":"promote","route":"/docs/speakeasy-reference/cli/tag/promote","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:17:children:1:frontMatter","title":"promote","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:17:frontMatter","title":"tag","type":"doc"},{"name":"test","route":"/docs/speakeasy-reference/cli/test","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:18:frontMatter","title":"test","type":"doc"},{"name":"update","route":"/docs/speakeasy-reference/cli/update","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:children:19:frontMatter","title":"update","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:frontMatter","title":"CLI","type":"doc"},{"name":"generation","route":"/docs/speakeasy-reference/generation","children":[{"name":"gen-yaml","route":"/docs/speakeasy-reference/generation/gen-yaml","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:1:frontMatter","title":"Config File","type":"doc"},{"name":"ci-cd-pipeline","route":"/docs/speakeasy-reference/generation/ci-cd-pipeline","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:2:frontMatter","title":"CI/CD Pipeline","type":"doc"},{"name":"ts-config","route":"/docs/speakeasy-reference/generation/ts-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:3:frontMatter","title":"TypeScript Configuration","type":"doc"},{"name":"python-config","route":"/docs/speakeasy-reference/generation/python-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:4:frontMatter","title":"Python Configuration","type":"doc"},{"name":"go-config","route":"/docs/speakeasy-reference/generation/go-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:5:frontMatter","title":"Go Configuration","type":"doc"},{"name":"java-config","route":"/docs/speakeasy-reference/generation/java-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:6:frontMatter","title":"Java Configuration","type":"doc"},{"name":"csharp-config","route":"/docs/speakeasy-reference/generation/csharp-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:7:frontMatter","title":"C# Configuration","type":"doc"},{"name":"php-config","route":"/docs/speakeasy-reference/generation/php-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:8:frontMatter","title":"PHP Configuration","type":"doc"},{"name":"ruby-config","route":"/docs/speakeasy-reference/generation/ruby-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:9:frontMatter","title":"Ruby Configuration","type":"doc"},{"name":"swift-config","route":"/docs/speakeasy-reference/generation/swift-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:10:frontMatter","title":"Swift Configuration","type":"doc"},{"name":"terraform-config","route":"/docs/speakeasy-reference/generation/terraform-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:2:children:11:frontMatter","title":"Terraform Configuration","type":"doc"}],"title":"Generation Config","type":"doc"},{"name":"extensions","route":"/docs/speakeasy-reference/extensions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:3:frontMatter","title":"Speakeasy extensions","type":"doc"},{"name":"workflow-file","route":"/docs/speakeasy-reference/workflow-file","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:4:frontMatter","title":"Speakeasy Workflow File","type":"doc"}],"title":"Speakeasy","type":"doc"},{"name":"supported","route":"/docs/supported","children":[{"name":"openapi","route":"/docs/supported/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:30:children:0:frontMatter","title":"OpenAPI Support Matrix","type":"doc"},{"name":"terraform","route":"/docs/supported/terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:30:children:1:frontMatter","title":"Speakeasy Terraform provider support matrix","type":"doc"}],"title":"Supported","type":"doc"},"$5:0:props:menuData:29",{"name":"slack-community","href":"https://go.speakeasy.com/slack","title":"Slack Community","type":"doc"},{"name":"enterprise-support","route":"/docs/enterprise-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:33:frontMatter","title":"Enterprise Support","type":"doc"},"$5:0:props:menuData:32",{"name":"product-security","route":"/docs/product-security","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:35:frontMatter","title":"Product Security","type":"doc"},{"name":"privacy-policy","route":"/docs/privacy-policy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:36:frontMatter","title":"Privacy Policy","type":"doc"},{"name":"terms-of-service","route":"/docs/terms-of-service","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:37:frontMatter","title":"Terms of Service","type":"doc"},{"name":"guides","route":"/docs/guides","children":[{"name":"code-samples-without-github-actions","route":"/docs/guides/code-samples-without-github-actions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:38:children:0:frontMatter","title":"Using the CLI to populate code samples without GitHub Actions","type":"doc"}],"title":"Guides","type":"doc"}],"title":"Documentation","type":"page","display":"children"},"$5:0:props:activePath:0:children:10","$5:0:props:activePath:0:children:10:children:5","$5:0:props:activePath:0:children:10:children:5:children:1"]}],["$","div",null,{"className":"docs-layout-default docs-content docs","children":["$","$L21",null,{"value":[{"value":"Installing the CLIs","id":"installing-the-clis","depth":2},{"value":"Installing the Speakeasy CLI","id":"installing-the-speakeasy-cli","depth":3},{"value":"Installing the OpenAPI Generator CLI","id":"installing-the-openapi-generator-cli","depth":3},{"value":"Downloading the Swagger Petstore specification","id":"downloading-the-swagger-petstore-specification","depth":2},{"value":"Validating the specification file","id":"validating-the-specification-file","depth":2},{"value":"Validation using Speakeasy","id":"validation-using-speakeasy","depth":3},{"value":"Validation using OpenAPI Generator","id":"validation-using-openapi-generator","depth":3},{"value":"Creating SDKs","id":"creating-sdks","depth":2},{"value":"Creating an SDK with Speakeasy","id":"creating-an-sdk-with-speakeasy","depth":3},{"value":"Creating an SDK with OpenAPI Generator","id":"creating-an-sdk-with-openapi-generator","depth":3},{"value":"SDK code compared: Project structure","id":"sdk-code-compared-project-structure","depth":2},{"value":"Model and usage","id":"model-and-usage","depth":2},{"value":"HTTP communication","id":"http-communication","depth":2},{"value":"Retries","id":"retries","depth":2},{"value":"SDK dependencies","id":"sdk-dependencies","depth":2},{"value":"Handling non-nullable fields","id":"handling-non-nullable-fields","depth":2},{"value":"Generated documentation","id":"generated-documentation","depth":2},{"value":"Supported Java versions","id":"supported-java-versions","depth":2},{"value":"Summary","id":"summary","depth":2}],"children":[["$","$L22",null,{}],["$","$L23",null,{"metadata":{"title":"Comparison guide: OpenAPI/Swagger Java client generation","filePath":"src/content/docs/languages/java/oss-comparison-java.mdx","description":"Comparing the new Speakeasy Java SDK generator with the open-source OpenAPI Java generators","keywords":["api","openapi","swagger","sdk generation","sdk","java","sdk","developer experience","devex","dx"],"date":"2024-05-08","timestamp":1746647952000},"bottomContent":"$undefined","children":[["$","div",null,{"id":"nextra-skip-nav"}],["$","main",null,{"data-pagefind-body":true,"children":[false,false,[["$","h1",null,{"id":"$undefined","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-bold x:mt-2 x:text-4xl","children":["Comparison guide: OpenAPI/Swagger Java client generation","$undefined"]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"At Speakeasy, the team specializes in producing idiomatic SDKs in various programming languages, including Java. The approach to SDK generation prioritizes a rich developer experience that enables API providers to concentrate on refining APIs and empowers developer-users to efficiently leverage services."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["In this article, we’ll compare creating a Java SDK using Speakeasy to creating one using the ",["$","a",null,{"href":"https://github.com/OpenAPITools/openapi-generator","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["OpenAPI Generator",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],"."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Below is a table that summarizes the key differences between the two SDKs:"}],"\n",["$","div",null,{"className":"table-section flex w-full flex-col gap-2","children":["$undefined",["$","div",null,{"className":"md:hidden","children":["$","div",null,{"className":"mobile-table-section flex w-full flex-col gap-2","children":["$undefined",["$","span",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-muted-foreground font-mono uppercase mt-2 mb-0","children":"Feature"}],["$","div",null,{"className":"w-full overflow-hidden rounded-md border","children":[["$","div","default",{"children":["$undefined",[["$","div","Minimum version",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Minimum version"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Java 11+ (modern features)"}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Java 8+ (legacy support)"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","Dependencies",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Dependencies"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Minimal dependencies"}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Many third-party dependencies"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","HTTP client",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"HTTP client"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Native Java 11 ",["$","$L24","code-0",{"code":"java.net.http","fontSize":"small","inline":true,"className":"border-border w-auto [&_.snippet-inner]:px-1 [&_.snippet-inner]:py-0","language":"text"}]]}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Third-party OkHttp dependency"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","JSON processing",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"JSON processing"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["✅ ",["$","a","a-0",{"href":"https://github.com/FasterXML/jackson","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus [&_svg]:shrink-0","children":["Jackson",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," (enterprise-ready, faster)"]}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["⚠️ ",["$","a","a-0",{"href":"https://github.com/google/gson","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus [&_svg]:shrink-0","children":["Gson",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," (simpler, limited config)"]}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","Builder pattern",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Builder pattern"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Modern builder pattern"}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Traditional setters only"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","Null safety",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Null safety"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["✅ Proactive with ",["$","$L24","code-0",{"code":"Optional","fontSize":"small","inline":true,"className":"border-border w-auto [&_.snippet-inner]:px-1 [&_.snippet-inner]:py-0","language":"text"}]," support"]}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Basic retrospective validation"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","Retry support",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Retry support"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Built-in configurable retries"}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Not supported"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","Documentation",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Documentation"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Comprehensive, with examples"}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Basic documentation"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","Collections",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Collections"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Modern list implementations"}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Mix of arrays and lists"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","Field access",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Field access"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Encapsulated (getter methods)"}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Direct field access"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","OAuth support",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"OAuth support"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Built-in OAuth 2.0"}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Requires additional library"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}],["$","div","Pagination",{"children":[["$","div",null,{"className":"bg-muted/30 border-b px-2 py-1.5 [&_span]:text-sm [&_span]:font-semibold","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Pagination"}]]}],["$","div",null,{"className":"grid grid-cols-2 border-b","children":[["$","div",null,{"className":"border-r","children":[["$","div","support",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Speakeasy"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Supported"}]]}]]}]}]}],["$","div","docs",{"children":["$","div",null,{"className":"px-4 py-1.5 border-t","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"OpenAPI Generator"}],["$","div",null,{"className":"text-sm break-words","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Not supported"}]]}]]}]}]}]]}],["$","div",null,{"children":[["$","div","notes",{"children":["$","div",null,{"className":"px-4 py-1.5 ","children":["$","div",null,{"className":"space-y-1","children":[["$","div",null,{"className":"text-muted-foreground text-xs font-medium","children":"Notes"}],["$","div",null,{"className":"text-sm break-words","children":"$undefined"}]]}]}]}]]}]]}]]}]]]}]]}]]}]}],["$","div",null,{"className":"hidden md:block","children":["$","div",null,{"className":"table-section flex w-full flex-col gap-2","children":["$undefined",["$","div",null,{"className":"w-full overflow-hidden rounded-md border","children":["$","div",null,{"data-slot":"table-container","className":"relative w-full overflow-x-auto","children":["$","table",null,{"data-slot":"table","className":"caption-bottom text-sm w-full table-auto","style":{"tableLayout":"auto"},"children":[["$","thead",null,{"data-slot":"table-header","className":"[&_tr]:interact:bg-card [&_tr]:border-b","children":["$","tr",null,{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors bg-muted/50","children":[["$","th","name",{"data-slot":"table-head","className":"text-foreground typography-body-md h-10 p-4 text-left align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] w-auto font-semibold","children":"Feature"}],["$","th","support",{"data-slot":"table-head","className":"text-foreground typography-body-md h-10 p-4 text-left align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] w-auto font-semibold","children":"Speakeasy"}],["$","th","docs",{"data-slot":"table-head","className":"text-foreground typography-body-md h-10 p-4 text-left align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] w-auto font-semibold","children":"OpenAPI Generator"}],["$","th","notes",{"data-slot":"table-head","className":"text-foreground typography-body-md h-10 p-4 text-left align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] w-auto font-semibold","children":"Notes"}]]}]}],["$","tbody",null,{"data-slot":"table-body","className":"[&_tr:last-child]:border-0","children":[["$","$1","default",{"children":["$undefined",[["$","tr","Minimum version",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Minimum version"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Java 11+ (modern features)"}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Java 8+ (legacy support)"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","Dependencies",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Dependencies"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Minimal dependencies"}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Many third-party dependencies"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","HTTP client",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"HTTP client"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Native Java 11 ",["$","$L24","code-0",{"code":"java.net.http","fontSize":"small","inline":true,"className":"border-border w-auto [&_.snippet-inner]:px-1 [&_.snippet-inner]:py-0","language":"text"}]]}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Third-party OkHttp dependency"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","JSON processing",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"JSON processing"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["✅ ",["$","a","a-0",{"href":"https://github.com/FasterXML/jackson","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus [&_svg]:shrink-0","children":["Jackson",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," (enterprise-ready, faster)"]}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["⚠️ ",["$","a","a-0",{"href":"https://github.com/google/gson","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus [&_svg]:shrink-0","children":["Gson",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," (simpler, limited config)"]}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","Builder pattern",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Builder pattern"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Modern builder pattern"}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Traditional setters only"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","Null safety",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Null safety"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["✅ Proactive with ",["$","$L24","code-0",{"code":"Optional","fontSize":"small","inline":true,"className":"border-border w-auto [&_.snippet-inner]:px-1 [&_.snippet-inner]:py-0","language":"text"}]," support"]}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Basic retrospective validation"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","Retry support",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Retry support"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Built-in configurable retries"}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Not supported"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","Documentation",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Documentation"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Comprehensive, with examples"}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Basic documentation"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","Collections",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Collections"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Modern list implementations"}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Mix of arrays and lists"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","Field access",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Field access"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Encapsulated (getter methods)"}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Direct field access"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","OAuth support",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"OAuth support"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Built-in OAuth 2.0"}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"⚠️ Requires additional library"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}],["$","tr","Pagination",{"data-slot":"table-row","className":"interact:bg-card data-[state=selected]:bg-card border-b transition-colors hover:bg-muted/20","children":[["$","td","name",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Pagination"}]]}],["$","td","support",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"✅ Supported"}]]}],["$","td","docs",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":[["$","span","p-0",{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"❌ Not supported"}]]}],["$","td","notes",{"data-slot":"table-cell","className":"p-3 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px] pl-6","children":"$undefined"}]]}]]]}]]}]]}]}]}]]}]}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Read more about these headline features of Speakeasy-created Java SDKs in the ",["$","$L25",null,{"href":"/post/release-java-ga","prefetch":"$undefined","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":"March 2024 release notes"}],", or consult the ",["$","$L25",null,{"href":"/docs/languages/java/methodology-java","prefetch":"$undefined","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":"Speakeasy Java SDK documentation"}],"."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"For a detailed technical comparison, read on!"}],"\n",["$","h2",null,{"id":"installing-the-clis","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Installing the CLIs",["$","$L26",null,{"id":"installing-the-clis"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"For this comparison, we need both the Speakeasy and OpenAPI Generator CLIs installed to generate the Java SDKs from the specification YAML file. We’re using macOS, so we use Homebrew to install the CLIs."}],"\n",["$","h3",null,{"id":"installing-the-speakeasy-cli","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Installing the Speakeasy CLI",["$","$L26",null,{"id":"installing-the-speakeasy-cli"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Install the Speakeasy CLI by running the following command in the terminal:"}],"\n",["$","$L27",null,{"codeblock":{"value":"brew install speakeasy-api/homebrew-tap/speakeasy","lang":"shellscript","meta":"","code":"brew install speakeasy-api/homebrew-tap/speakeasy","tokens":[["brew","#A6E22E"]," ",["install speakeasy-api/homebrew-tap/speakeasy","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"You can check the version to ensure installation was successful:"}],"\n",["$","$L27",null,{"codeblock":{"value":"speakeasy -v","lang":"shellscript","meta":"","code":"speakeasy -v","tokens":[["speakeasy","#A6E22E"]," ",["-v","#AE81FF"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["If you encounter any errors, take a look at the ",["$","$L25",null,{"href":"/docs/create-client-sdks","prefetch":"$undefined","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":"Speakeasy SDK creation documentation"}],"."]}],"\n",["$","h3",null,{"id":"installing-the-openapi-generator-cli","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Installing the OpenAPI Generator CLI",["$","$L26",null,{"id":"installing-the-openapi-generator-cli"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Install the OpenAPI Generator CLI by running the following command in the terminal:"}],"\n",["$","$L27",null,{"codeblock":{"value":"brew install openapi-generator","lang":"shellscript","meta":"","code":"brew install openapi-generator","tokens":[["brew","#A6E22E"]," ",["install openapi-generator","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"You can check the version:"}],"\n",["$","$L27",null,{"codeblock":{"value":"openapi-generator version","lang":"shellscript","meta":"","code":"openapi-generator version","tokens":[["openapi-generator","#A6E22E"]," ",["version","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Browse the ",["$","a",null,{"href":"https://github.com/OpenAPITools/openapi-generator/blob/master/README.md","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["OpenAPI Generator documentation",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," if any errors occur."]}],"\n",["$","h2",null,{"id":"downloading-the-swagger-petstore-specification","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Downloading the Swagger Petstore specification",["$","$L26",null,{"id":"downloading-the-swagger-petstore-specification"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["We need an OpenAPI specification YAML file to generate SDKs for. We’ll use the Swagger Petstore specification, which you can find at ",["$","a",null,{"href":"https://petstore3.swagger.io/api/v3/openapi.yaml","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["https://petstore3.swagger.io/api/v3/openapi.yaml",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],"."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Download the file in and save it as ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"petstore.yaml"}]," with the following command in the terminal:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"curl https://petstore3.swagger.io/api/v3/openapi.yaml --output petstore.yaml","lang":"shellscript","meta":"","code":"curl https://petstore3.swagger.io/api/v3/openapi.yaml --output petstore.yaml","tokens":[["curl","#A6E22E"]," ",["https://petstore3.swagger.io/api/v3/openapi.yaml","#E6DB74"]," ",["--output","#AE81FF"]," ",["petstore.yaml","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","h2",null,{"id":"validating-the-specification-file","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Validating the specification file",["$","$L26",null,{"id":"validating-the-specification-file"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Let’s validate the spec using both the Speakeasy CLI and OpenAPI Generator."}],"\n",["$","h3",null,{"id":"validation-using-speakeasy","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Validation using Speakeasy",["$","$L26",null,{"id":"validation-using-speakeasy"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Run the following command in the terminal where the specification file is located:"}],"\n",["$","$L27",null,{"codeblock":{"value":"speakeasy validate openapi -s petstore.yaml","lang":"shellscript","meta":"","code":"speakeasy validate openapi -s petstore.yaml","tokens":[["speakeasy","#A6E22E"]," ",["validate openapi","#E6DB74"]," ",["-s","#AE81FF"]," ",["petstore.yaml","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The Speakeasy validator returns the following:"}],"\n",["$","$L27",null,{"codeblock":{"value":"$28","lang":"shellscript","meta":"","code":"$29","tokens":[["╭────────────╮╭───────────────╮╭────────────╮","#A6E22E"],"\n",["│","#A6E22E"]," ",["Errors","#E6DB74"]," ",["(0) ││ Warnings (","#F8F8F2"],["10","#A6E22E"],[") ││ Hints (","#F8F8F2"],["72","#A6E22E"],[") │","#F8F8F2"],"\n",["├────────────┴┘","#A6E22E"]," ",["└┴────────────┴────────────────────────────────────────────────────────────╮","#E6DB74"],"\n",["│","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ Line 250: operation-success-response - operation `","#E6DB74"],["updatePetWithForm","#A6E22E"],["`","#E6DB74"]," ",["must","#A6E22E"]," ",["define at least a single │","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ `","#E6DB74"],["2xx","#A6E22E"],["`","#E6DB74"]," ",["or","#A6E22E"]," ",["`","#E6DB74"],["3xx","#A6E22E"],["`","#E6DB74"]," ",["response","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["Line 277: operation-success-response - operation `","#E6DB74"],["deletePet","#A6E22E"],["`","#E6DB74"]," ",["must","#A6E22E"]," ",["define at least a single `","#E6DB74"],["2xx","#A6E22E"],["`","#E6DB74"]," ",["or","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["`","#E6DB74"],["3xx","#A6E22E"],["`","#E6DB74"]," ",["response","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["Line 413: operation-success-response - operation `","#E6DB74"],["deleteOrder","#A6E22E"],["`","#E6DB74"]," ",["must","#A6E22E"]," ",["define at least a single `","#E6DB74"],["2xx","#A6E22E"],["`","#E6DB74"]," ",["o","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["r │","#E6DB74"],"\n",["│","#A6E22E"]," ",["`","#E6DB74"],["3xx","#A6E22E"],["`","#E6DB74"]," ",["response","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["Line 437: operation-success-response - operation `","#E6DB74"],["createUser","#A6E22E"],["`","#E6DB74"]," ",["must","#A6E22E"]," ",["define at least a single `","#E6DB74"],["2xx","#A6E22E"],["`","#E6DB74"]," ",["or","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["`","#E6DB74"],["3xx","#A6E22E"],["`","#E6DB74"]," ",["response","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["Line 524: operation-success-response - operation `","#E6DB74"],["logoutUser","#A6E22E"],["`","#E6DB74"]," ",["must","#A6E22E"]," ",["define at least a single `","#E6DB74"],["2xx","#A6E22E"],["`","#E6DB74"]," ",["or","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["`","#E6DB74"],["3xx","#A6E22E"],["`","#E6DB74"]," ",["response","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["│","#E6DB74"],"\n",["│","#A6E22E"]," ",["•• │","#E6DB74"],"\n",["└────────────────────────────────────────────────────────────────────────────────────────────────────────┘","#A6E22E"],"\n ",["←/→","#A6E22E"]," ",["switch tabs ↑/↓ navigate ↵ inspect esc quit","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The Speakeasy CLI validation result gives us a handy tool for switching between the errors, warnings, and hints tabs with the option to navigate through the results on each tab."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"In this instance, Speakeasy generated ten warnings. Let’s correct them before continuing."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Notice that some of the warnings contain a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"default"}]," response. For completeness, we’d like to explicitly return a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"200"}]," HTTP response. We’ll make the following modifications in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"petstore.yaml"}]," file."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["When the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"updatePetWithForm"}]," operation executes successfully, we expect an HTTP ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"200"}]," response with the updated ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object to be returned."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Insert the following after ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"responses"}]," on line 250:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"\"200\":\n description: successful operation\n content:\n application/xml:\n schema:\n $ref: '#/components/schemas/Pet'\n application/json:\n schema:\n $ref: '#/components/schemas/Pet'","lang":"txt","meta":"","code":"\"200\":\n description: successful operation\n content:\n application/xml:\n schema:\n $ref: '#/components/schemas/Pet'\n application/json:\n schema:\n $ref: '#/components/schemas/Pet'","tokens":[["\"200\":","#F8F8F2"],"\n ",["description: successful operation","#F8F8F2"],"\n ",["content:","#F8F8F2"],"\n ",["application/xml:","#F8F8F2"],"\n ",["schema:","#F8F8F2"],"\n ",["$$ref: '#/components/schemas/Pet'","#F8F8F2"],"\n ",["application/json:","#F8F8F2"],"\n ",["schema:","#F8F8F2"],"\n ",["$$ref: '#/components/schemas/Pet'","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Similarly, following successful ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"createUser"}]," and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"updateUser"}]," operations, we’d like to return an HTTP ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"200"}]," response with a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"User"}]," object."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Add the following text to both operations below ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"responses"}],":"]}],"\n",["$","$L27",null,{"codeblock":{"value":"\"200\":\n description: successful operation\n content:\n application/xml:\n schema:\n $ref: '#/components/schemas/User'\n application/json:\n schema:\n $ref: '#/components/schemas/User'","lang":"txt","meta":"","code":"\"200\":\n description: successful operation\n content:\n application/xml:\n schema:\n $ref: '#/components/schemas/User'\n application/json:\n schema:\n $ref: '#/components/schemas/User'","tokens":[["\"200\":","#F8F8F2"],"\n ",["description: successful operation","#F8F8F2"],"\n ",["content:","#F8F8F2"],"\n ",["application/xml:","#F8F8F2"],"\n ",["schema:","#F8F8F2"],"\n ",["$$ref: '#/components/schemas/User'","#F8F8F2"],"\n ",["application/json:","#F8F8F2"],"\n ",["schema:","#F8F8F2"],"\n ",["$$ref: '#/components/schemas/User'","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Now we’ll add the same response to four operations. Copy the following text:"}],"\n",["$","$L27",null,{"codeblock":{"value":"\"200\":\n description: successful operation","lang":"txt","meta":"","code":"\"200\":\n description: successful operation","tokens":[["\"200\":","#F8F8F2"],"\n ",["description: successful operation","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Paste this response after ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"responses"}]," for the following operations:"]}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":["$","code",null,{"className":"nextra-code","dir":"ltr","children":"deletePet"}]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["$","code",null,{"className":"nextra-code","dir":"ltr","children":"deleteOrder"}]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["$","code",null,{"className":"nextra-code","dir":"ltr","children":"logoutUser"}]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["$","code",null,{"className":"nextra-code","dir":"ltr","children":"deleteUser"}]}],"\n"]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"We are left with three warnings indicating potentially unused or orphaned objects and operations."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"For unused objects, locate the following lines of code and delete them:"}],"\n",["$","$L27",null,{"codeblock":{"value":"Customer:\n type: object\n properties:\n id:\n type: integer\n format: int64\n example: 100000\n username:\n type: string\n example: fehguy\n address:\n type: array\n xml:\n name: addresses\n wrapped: true\n items:\n $ref: '#/components/schemas/Address'\n xml:\n name: customer\nAddress:\n type: object\n properties:\n street:\n type: string\n example: 437 Lytton\n city:\n type: string\n example: Palo Alto\n state:\n type: string\n example: CA\n zip:\n type: string\n example: \"94301\"\n xml:\n name: address","lang":"txt","meta":"","code":"Customer:\n type: object\n properties:\n id:\n type: integer\n format: int64\n example: 100000\n username:\n type: string\n example: fehguy\n address:\n type: array\n xml:\n name: addresses\n wrapped: true\n items:\n $ref: '#/components/schemas/Address'\n xml:\n name: customer\nAddress:\n type: object\n properties:\n street:\n type: string\n example: 437 Lytton\n city:\n type: string\n example: Palo Alto\n state:\n type: string\n example: CA\n zip:\n type: string\n example: \"94301\"\n xml:\n name: address","tokens":[["Customer:","#F8F8F2"],"\n ",["type: object","#F8F8F2"],"\n ",["properties:","#F8F8F2"],"\n ",["id:","#F8F8F2"],"\n ",["type: integer","#F8F8F2"],"\n ",["format: int64","#F8F8F2"],"\n ",["example: 100000","#F8F8F2"],"\n ",["username:","#F8F8F2"],"\n ",["type: string","#F8F8F2"],"\n ",["example: fehguy","#F8F8F2"],"\n ",["address:","#F8F8F2"],"\n ",["type: array","#F8F8F2"],"\n ",["xml:","#F8F8F2"],"\n ",["name: addresses","#F8F8F2"],"\n ",["wrapped: true","#F8F8F2"],"\n ",["items:","#F8F8F2"],"\n ",["$$ref: '#/components/schemas/Address'","#F8F8F2"],"\n ",["xml:","#F8F8F2"],"\n ",["name: customer","#F8F8F2"],"\n",["Address:","#F8F8F2"],"\n ",["type: object","#F8F8F2"],"\n ",["properties:","#F8F8F2"],"\n ",["street:","#F8F8F2"],"\n ",["type: string","#F8F8F2"],"\n ",["example: 437 Lytton","#F8F8F2"],"\n ",["city:","#F8F8F2"],"\n ",["type: string","#F8F8F2"],"\n ",["example: Palo Alto","#F8F8F2"],"\n ",["state:","#F8F8F2"],"\n ",["type: string","#F8F8F2"],"\n ",["example: CA","#F8F8F2"],"\n ",["zip:","#F8F8F2"],"\n ",["type: string","#F8F8F2"],"\n ",["example: \"94301\"","#F8F8F2"],"\n ",["xml:","#F8F8F2"],"\n ",["name: address","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"To remove the unused request bodies, locate the following lines and delete them:"}],"\n",["$","$L27",null,{"codeblock":{"value":"requestBodies:\n Pet:\n description: Pet object that needs to be added to the store\n content:\n application/json:\n schema:\n $ref: '#/components/schemas/Pet'\n application/xml:\n schema:\n $ref: '#/components/schemas/Pet'\n UserArray:\n description: List of user object\n content:\n application/json:\n schema:\n type: array\n items:\n $ref: '#/components/schemas/User'","lang":"txt","meta":"","code":"requestBodies:\n Pet:\n description: Pet object that needs to be added to the store\n content:\n application/json:\n schema:\n $ref: '#/components/schemas/Pet'\n application/xml:\n schema:\n $ref: '#/components/schemas/Pet'\n UserArray:\n description: List of user object\n content:\n application/json:\n schema:\n type: array\n items:\n $ref: '#/components/schemas/User'","tokens":[["requestBodies:","#F8F8F2"],"\n ",["Pet:","#F8F8F2"],"\n ",["description: Pet object that needs to be added to the store","#F8F8F2"],"\n ",["content:","#F8F8F2"],"\n ",["application/json:","#F8F8F2"],"\n ",["schema:","#F8F8F2"],"\n ",["$$ref: '#/components/schemas/Pet'","#F8F8F2"],"\n ",["application/xml:","#F8F8F2"],"\n ",["schema:","#F8F8F2"],"\n ",["$$ref: '#/components/schemas/Pet'","#F8F8F2"],"\n ",["UserArray:","#F8F8F2"],"\n ",["description: List of user object","#F8F8F2"],"\n ",["content:","#F8F8F2"],"\n ",["application/json:","#F8F8F2"],"\n ",["schema:","#F8F8F2"],"\n ",["type: array","#F8F8F2"],"\n ",["items:","#F8F8F2"],"\n ",["$$ref: '#/components/schemas/User'","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Now if you validate the file with the Speakeasy CLI, you’ll notice there are no warnings:"}],"\n",["$","$L27",null,{"codeblock":{"value":"$2a","lang":"txt","meta":"","code":"$2b","tokens":[["╭────────────╮╭──────────────╮╭────────────╮","#F8F8F2"],"\n",["│ Errors (0) ││ Warnings (0) ││ Hints (75) │","#F8F8F2"],"\n",["├────────────┴┴──────────────┴┘ └─────────────────────────────────────────────────────────────╮","#F8F8F2"],"\n",["│ │","#F8F8F2"],"\n",["│ │ Line 51: missing-examples - Missing example for requestBody. Consider adding an example │","#F8F8F2"],"\n",["│ │","#F8F8F2"],"\n",["│ Line 54: missing-examples - Missing example for requestBody. Consider adding an example │","#F8F8F2"],"\n",["│ │","#F8F8F2"],"\n",["│ Line 57: missing-examples - Missing example for requestBody. Consider adding an example │","#F8F8F2"],"\n",["│ │","#F8F8F2"],"\n",["│ Line 65: missing-examples - Missing example for responses. Consider adding an example │","#F8F8F2"],"\n",["│ │","#F8F8F2"],"\n",["│ Line 68: missing-examples - Missing example for responses. Consider adding an example │","#F8F8F2"],"\n",["│ │","#F8F8F2"],"\n",["│ ••••••••••••••• │","#F8F8F2"],"\n",["└────────────────────────────────────────────────────────────────────────────────────────────────────────┘","#F8F8F2"],"\n\n ",["←/→ switch tabs ↑/↓ navigate ↵ inspect esc quit","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","h3",null,{"id":"validation-using-openapi-generator","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Validation using OpenAPI Generator",["$","$L26",null,{"id":"validation-using-openapi-generator"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["To validate the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"petstore.yaml"}]," specification file with OpenAPI Generator, run the following command in the terminal:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"openapi-generator validate -i petstore.yaml","lang":"shellscript","meta":"","code":"openapi-generator validate -i petstore.yaml","tokens":[["openapi-generator","#A6E22E"]," ",["validate","#E6DB74"]," ",["-i","#AE81FF"]," ",["petstore.yaml","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The OpenAPI Generator returns the following response, indicating no issues detected."}],"\n",["$","$L27",null,{"codeblock":{"value":"Validating spec (petstore.yaml)\nNo validation issues detected.","lang":"shellscript","meta":"","code":"Validating spec (petstore.yaml)\nNo validation issues detected.","tokens":[["Validating","#A6E22E"]," ",["spec","#E6DB74"]," ",["(petstore.yaml)","#F8F8F2"],"\n",["No","#A6E22E"]," ",["validation issues detected.","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Now that we have made the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"petstore.yaml"}]," file more complete by fixing the warnings, let’s use it to create SDKs."]}],"\n",["$","h2",null,{"id":"creating-sdks","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Creating SDKs",["$","$L26",null,{"id":"creating-sdks"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"We’ll create Java SDKs using Speakeasy and OpenAPI Generator and then compare them."}],"\n",["$","h3",null,{"id":"creating-an-sdk-with-speakeasy","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Creating an SDK with Speakeasy",["$","$L26",null,{"id":"creating-an-sdk-with-speakeasy"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Create a Java SDK from the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"petstore.yaml"}]," specification file using Speakeasy by running the following command in the terminal:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"# Generate Petstore SDK using Speakeasy java generator\nspeakeasy generate sdk \\\n --schema petstore.yaml \\\n --lang java \\\n --out ./sdks/petstore-sdk-java-speakeasy/","lang":"shellscript","meta":"","code":"# Generate Petstore SDK using Speakeasy java generator\nspeakeasy generate sdk \\\n --schema petstore.yaml \\\n --lang java \\\n --out ./sdks/petstore-sdk-java-speakeasy/","tokens":[["# Generate Petstore SDK using Speakeasy java generator","#88846F"],"\n",["speakeasy","#A6E22E"]," ",["generate sdk","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--schema","#AE81FF"]," ",["petstore.yaml","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--lang","#AE81FF"]," ",["java","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--out","#AE81FF"]," ",["./sdks/petstore-sdk-java-speakeasy/","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The generator will return some logging results while the SDK is being created and a success indicator on completion."}],"\n",["$","$L27",null,{"codeblock":{"value":"SDK for java generated successfully ✓","lang":"shellscript","meta":"","code":"SDK for java generated successfully ✓","tokens":[["SDK","#A6E22E"]," ",["for java generated successfully ✓","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","h3",null,{"id":"creating-an-sdk-with-openapi-generator","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Creating an SDK with OpenAPI Generator",["$","$L26",null,{"id":"creating-an-sdk-with-openapi-generator"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Run the following command in the terminal to generate a Java SDK using OpenAPI Generator:"}],"\n",["$","$L27",null,{"codeblock":{"value":"# Generate Petstore SDK using python generator\nopenapi-generator generate \\\n --input-spec petstore.yaml \\\n --generator-name java \\\n --output ./sdks/petstore-sdk-java \\\n --additional-properties=packageName=petstore_sdk,projectName=petstore-sdk-java","lang":"shellscript","meta":"","code":"# Generate Petstore SDK using python generator\nopenapi-generator generate \\\n --input-spec petstore.yaml \\\n --generator-name java \\\n --output ./sdks/petstore-sdk-java \\\n --additional-properties=packageName=petstore_sdk,projectName=petstore-sdk-java","tokens":[["# Generate Petstore SDK using python generator","#88846F"],"\n",["openapi-generator","#A6E22E"]," ",["generate","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--input-spec","#AE81FF"]," ",["petstore.yaml","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--generator-name","#AE81FF"]," ",["java","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--output","#AE81FF"]," ",["./sdks/petstore-sdk-java","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--additional-properties=packageName=petstore_sdk,projectName=petstore-sdk-java","#AE81FF"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The generator returns various logs and finally a successful generation message."}],"\n",["$","$L27",null,{"codeblock":{"value":"################################################################################\n# Thanks for using OpenAPI Generator. #\n# Please consider donation to help us maintain this project 🙏 #\n# https://opencollective.com/openapi_generator/donate #\n################################################################################","lang":"shellscript","meta":"","code":"################################################################################\n# Thanks for using OpenAPI Generator. #\n# Please consider donation to help us maintain this project 🙏 #\n# https://opencollective.com/openapi_generator/donate #\n################################################################################","tokens":[["################################################################################","#88846F"],"\n",["# Thanks for using OpenAPI Generator. #","#88846F"],"\n",["# Please consider donation to help us maintain this project 🙏 #","#88846F"],"\n",["# https://opencollective.com/openapi_generator/donate #","#88846F"],"\n",["################################################################################","#88846F"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","h2",null,{"id":"sdk-code-compared-project-structure","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["SDK code compared: Project structure",["$","$L26",null,{"id":"sdk-code-compared-project-structure"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Let’s compare the two project structures by printing a tree structure of each SDK directory’s ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"src"}]," folder."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Run the following command to get the Speakeasy SDK structure:"}],"\n",["$","$L27",null,{"codeblock":{"value":"cd petstore-sdk-java-speakeasy/src/main/java\ntree","lang":"shellscript","meta":"","code":"cd petstore-sdk-java-speakeasy/src/main/java\ntree","tokens":[["cd","#66D9EF"]," ",["petstore-sdk-java-speakeasy/src/main/java","#E6DB74"],"\n",["tree","#A6E22E"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The results of the project structure are displayed as follows:"}],"\n",["$","$L27",null,{"codeblock":{"value":"$2c","lang":"shellscript","meta":"","code":"$2d","tokens":[["||","#F92672"],["____org","#A6E22E"],"\n",["| |","#F92672"],["____openapis","#A6E22E"],"\n",["| | |","#F92672"],["____openapi","#A6E22E"],"\n",["| | | |","#F92672"],["____Pet.java","#A6E22E"],"\n",["| | | |","#F92672"],["____SecuritySource.java","#A6E22E"],"\n",["| | | |","#F92672"],["____User.java","#A6E22E"],"\n",["| | | |","#F92672"],["____utils","#A6E22E"],"\n",["| | | | |","#F92672"],["____SpeakeasyMetadata.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____SecurityMetadata.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____LazySingletonValue.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____RetryConfig.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____TypedObject.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____BigDecimalString.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Response.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____OneOfDeserializer.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____MultipartFormMetadata.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____JSON.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Hooks.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Deserializers.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____QueryParameters.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Utils.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____QueryParamsMetadata.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Retries.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____RequestBody.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____RequestMetadata.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Security.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Metadata.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____SpeakeasyHTTPClient.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____BackoffStrategy.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____SerializedBody.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Types.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____HTTPClient.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Options.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____HeaderMetadata.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____PathParamsMetadata.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____FormMetadata.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Hook.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____HTTPRequest.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____BigIntegerString.java","#A6E22E"],"\n",["| | | |","#F92672"],["____models","#A6E22E"],"\n",["| | | | |","#F92672"],["____operations","#A6E22E"],"\n",["| | | | | |","#F92672"],["____DeletePetRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetPetByIdSecurity.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdateUserFormResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____CreateUserFormResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____LoginUserRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdateUserRawRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____DeletePetResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetOrderByIdRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____SDKMethodInterfaces.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdateUserJsonRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____Status.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____FindPetsByStatusRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____DeleteOrderRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____CreateUserJsonResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdateUserJsonResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____DeleteOrderRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdateUserRawResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdatePetFormResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____PlaceOrderJsonRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____AddPetFormResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____PlaceOrderRawRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdatePetJsonRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____FindPetsByStatusRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____CreateUserRawRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____LoginUserRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____FindPetsByTagsRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____FindPetsByTagsRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____LogoutUserResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____FindPetsByStatusResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____DeleteUserRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdateUserRawRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____AddPetFormRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetInventorySecurity.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____DeleteUserRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____CreateUsersWithListInputResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____DeleteOrderResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdateUserJsonRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetPetByIdRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____CreateUserFormRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____CreateUserRawResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____AddPetJsonResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdatePetJsonResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetOrderByIdResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UploadFileResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____DeletePetRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdatePetWithFormResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____PlaceOrderJsonResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdateUserFormRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____LoginUserResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UploadFileRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____LogoutUserRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____FindPetsByTagsResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetPetByIdResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdatePetWithFormRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetPetByIdRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdatePetRawResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____CreateUsersWithListInputRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____AddPetRawResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____PlaceOrderFormResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetUserByNameResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdatePetWithFormRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetOrderByIdRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetInventoryResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____PlaceOrderFormRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UploadFileRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetInventoryRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdatePetFormRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdatePetRawRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____DeleteUserResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____CreateUserJsonRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetUserByNameRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____AddPetJsonRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____AddPetRawRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____GetUserByNameRequestBuilder.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____UpdateUserFormRequest.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____PlaceOrderRawResponse.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____components","#A6E22E"],"\n",["| | | | | |","#F92672"],["____Order.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____Status.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____Tag.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____ApiResponse.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____Pet.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____OrderStatus.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____Category.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____User.java","#A6E22E"],"\n",["| | | | | |","#F92672"],["____Security.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____errors","#A6E22E"],"\n",["| | | | | |","#F92672"],["____SDKError.java","#A6E22E"],"\n",["| | | |","#F92672"],["____Store.java","#A6E22E"],"\n",["| | | |","#F92672"],["____SDKConfiguration.java","#A6E22E"],"\n",["| | | |","#F92672"],["____SDK.java","#A6E22E"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Now run the following command for the OpenAPI Generator SDK folder:"}],"\n",["$","$L27",null,{"codeblock":{"value":"cd petstore-sdk-java/src/main/java\ntree","lang":"shellscript","meta":"","code":"cd petstore-sdk-java/src/main/java\ntree","tokens":[["cd","#66D9EF"]," ",["petstore-sdk-java/src/main/java","#E6DB74"],"\n",["tree","#A6E22E"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The OpenAPI Generator SDK structure looks like this:"}],"\n",["$","$L27",null,{"codeblock":{"value":"$2e","lang":"shellscript","meta":"","code":"$2f","tokens":[["|","#F92672"],["____org","#A6E22E"],"\n",["| |","#F92672"],["____openapitools","#A6E22E"],"\n",["| | |","#F92672"],["____client","#A6E22E"],"\n",["| | | |","#F92672"],["____ApiClient.java","#A6E22E"],"\n",["| | | |","#F92672"],["____ApiException.java","#A6E22E"],"\n",["| | | |","#F92672"],["____ProgressResponseBody.java","#A6E22E"],"\n",["| | | |","#F92672"],["____Pair.java","#A6E22E"],"\n",["| | | |","#F92672"],["____GzipRequestInterceptor.java","#A6E22E"],"\n",["| | | |","#F92672"],["____auth","#A6E22E"],"\n",["| | | | |","#F92672"],["____RetryingOAuth.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____HttpBasicAuth.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____ApiKeyAuth.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____OAuth.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____OAuthOkHttpClient.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Authentication.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____OAuthFlow.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____HttpBearerAuth.java","#A6E22E"],"\n",["| | | |","#F92672"],["____ApiResponse.java","#A6E22E"],"\n",["| | | |","#F92672"],["____JSON.java","#A6E22E"],"\n",["| | | |","#F92672"],["____ServerVariable.java","#A6E22E"],"\n",["| | | |","#F92672"],["____StringUtil.java","#A6E22E"],"\n",["| | | |","#F92672"],["____Configuration.java","#A6E22E"],"\n",["| | | |","#F92672"],["____ServerConfiguration.java","#A6E22E"],"\n",["| | | |","#F92672"],["____model","#A6E22E"],"\n",["| | | | |","#F92672"],["____Order.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____ModelApiResponse.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Customer.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Tag.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Pet.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____AbstractOpenApiSchema.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Category.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____User.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____Address.java","#A6E22E"],"\n",["| | | |","#F92672"],["____api","#A6E22E"],"\n",["| | | | |","#F92672"],["____PetApi.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____UserApi.java","#A6E22E"],"\n",["| | | | |","#F92672"],["____StoreApi.java","#A6E22E"],"\n",["| | | |","#F92672"],["____ApiCallback.java","#A6E22E"],"\n",["| | | |","#F92672"],["____ProgressRequestBody.java","#A6E22E"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The Speakeasy-created SDK contains more generated files than the SDK from OpenAPI Generator, which is partly due to the Speakeasy SDK being less dependent on third-party libraries."}],"\n",["$","h2",null,{"id":"model-and-usage","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Model and usage",["$","$L26",null,{"id":"model-and-usage"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Let’s take a look at how Speakeasy generates model classes for creating and updating a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object."]}],"\n",["$","$L27",null,{"codeblock":{"value":"Pet req = Pet.builder()\n .name(\"Snoopie\")\n .photoUrls(java.util.List.of(\n \"https://some_url.com/snoopie1.jpg\"))\n .id(1)\n .category(Category.builder()\n .id(1)\n .name(\"Dogs\")\n .build())\n .tags(java.util.List.of(\n Tag.builder()\n .build()))\n .status(Status.AVAILABLE)\n .build();\n\nUpdatePetJsonResponse res = sdk.pet().updatePetJson()\n .request(req)\n .call();\n\nif (res.body().isPresent()) {\n // handle response\n}","lang":"java","meta":"","code":"Pet req = Pet.builder()\n .name(\"Snoopie\")\n .photoUrls(java.util.List.of(\n \"https://some_url.com/snoopie1.jpg\"))\n .id(1)\n .category(Category.builder()\n .id(1)\n .name(\"Dogs\")\n .build())\n .tags(java.util.List.of(\n Tag.builder()\n .build()))\n .status(Status.AVAILABLE)\n .build();\n\nUpdatePetJsonResponse res = sdk.pet().updatePetJson()\n .request(req)\n .call();\n\nif (res.body().isPresent()) {\n // handle response\n}","tokens":[["Pet","#66D9EF",{"fontStyle":"italic"}]," ",["req","#F8F8F2"]," ",["=","#F92672"]," ",["Pet.","#F8F8F2"],["builder","#A6E22E"],["()","#F8F8F2"],"\n ",[".","#F8F8F2"],["name","#A6E22E"],["(","#F8F8F2"],["\"Snoopie\"","#E6DB74"],[")","#F8F8F2"],"\n ",[".","#F8F8F2"],["photoUrls","#A6E22E"],["(java.util.List.","#F8F8F2"],["of","#A6E22E"],["(","#F8F8F2"],"\n ",["\"https://some_url.com/snoopie1.jpg\"","#E6DB74"],["))","#F8F8F2"],"\n ",[".","#F8F8F2"],["id","#A6E22E"],["(","#F8F8F2"],["1","#AE81FF"],[")","#F8F8F2"],"\n ",[".","#F8F8F2"],["category","#A6E22E"],["(Category.","#F8F8F2"],["builder","#A6E22E"],["()","#F8F8F2"],"\n ",[".","#F8F8F2"],["id","#A6E22E"],["(","#F8F8F2"],["1","#AE81FF"],[")","#F8F8F2"],"\n ",[".","#F8F8F2"],["name","#A6E22E"],["(","#F8F8F2"],["\"Dogs\"","#E6DB74"],[")","#F8F8F2"],"\n ",[".","#F8F8F2"],["build","#A6E22E"],["())","#F8F8F2"],"\n ",[".","#F8F8F2"],["tags","#A6E22E"],["(java.util.List.","#F8F8F2"],["of","#A6E22E"],["(","#F8F8F2"],"\n ",["Tag.","#F8F8F2"],["builder","#A6E22E"],["()","#F8F8F2"],"\n ",[".","#F8F8F2"],["build","#A6E22E"],["()))","#F8F8F2"],"\n ",[".","#F8F8F2"],["status","#A6E22E"],["(Status.AVAILABLE)","#F8F8F2"],"\n ",[".","#F8F8F2"],["build","#A6E22E"],["();","#F8F8F2"],"\n\n",["UpdatePetJsonResponse","#66D9EF",{"fontStyle":"italic"}]," ",["res","#F8F8F2"]," ",["=","#F92672"]," ",["sdk.","#F8F8F2"],["pet","#A6E22E"],["().","#F8F8F2"],["updatePetJson","#A6E22E"],["()","#F8F8F2"],"\n ",[".","#F8F8F2"],["request","#A6E22E"],["(req)","#F8F8F2"],"\n ",[".","#F8F8F2"],["call","#A6E22E"],["();","#F8F8F2"],"\n\n",["if","#F92672"]," ",["(res.","#F8F8F2"],["body","#A6E22E"],["().","#F8F8F2"],["isPresent","#A6E22E"],["()) {","#F8F8F2"],"\n ",["// handle response","#88846F"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The Speakeasy model follows the builder pattern to construct objects with many optional parameters, making the code more readable and easier to use."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Let’s see how the OpenAPI Generator SDK performs the same operation:"}],"\n",["$","$L27",null,{"codeblock":{"value":" ApiClient defaultClient = Configuration.getDefaultApiClient();\n defaultClient.setBasePath(\"/api/v3\");\n\n // Configure OAuth2 access token for authorization: petstore_auth\n OAuth petstore_auth = (OAuth) defaultClient.getAuthentication(\"petstore_auth\");\n petstore_auth.setAccessToken(\"YOUR ACCESS TOKEN\");\n\n PetApi apiInstance = new PetApi(defaultClient);\n Pet pet = new Pet(); // Pet | Create a new pet in the store\n pet.setName(\"Snoopie\");\n try {\n Pet result = apiInstance.addPet(pet);\n System.out.println(result);\n } catch (ApiException e) {\n System.err.println(\"Exception when calling PetApi#addPet\");\n System.err.println(\"Status code: \" + e.getCode());\n System.err.println(\"Reason: \" + e.getResponseBody());\n System.err.println(\"Response headers: \" + e.getResponseHeaders());\n e.printStackTrace();\n }","lang":"java","meta":"","code":" ApiClient defaultClient = Configuration.getDefaultApiClient();\n defaultClient.setBasePath(\"/api/v3\");\n\n // Configure OAuth2 access token for authorization: petstore_auth\n OAuth petstore_auth = (OAuth) defaultClient.getAuthentication(\"petstore_auth\");\n petstore_auth.setAccessToken(\"YOUR ACCESS TOKEN\");\n\n PetApi apiInstance = new PetApi(defaultClient);\n Pet pet = new Pet(); // Pet | Create a new pet in the store\n pet.setName(\"Snoopie\");\n try {\n Pet result = apiInstance.addPet(pet);\n System.out.println(result);\n } catch (ApiException e) {\n System.err.println(\"Exception when calling PetApi#addPet\");\n System.err.println(\"Status code: \" + e.getCode());\n System.err.println(\"Reason: \" + e.getResponseBody());\n System.err.println(\"Response headers: \" + e.getResponseHeaders());\n e.printStackTrace();\n }","tokens":[" ",["ApiClient","#66D9EF",{"fontStyle":"italic"}]," ",["defaultClient","#F8F8F2"]," ",["=","#F92672"]," ",["Configuration.","#F8F8F2"],["getDefaultApiClient","#A6E22E"],["();","#F8F8F2"],"\n ",["defaultClient.","#F8F8F2"],["setBasePath","#A6E22E"],["(","#F8F8F2"],["\"/api/v3\"","#E6DB74"],[");","#F8F8F2"],"\n\n ",["// Configure OAuth2 access token for authorization: petstore_auth","#88846F"],"\n ",["OAuth","#66D9EF",{"fontStyle":"italic"}]," ",["petstore_auth","#F8F8F2"]," ",["=","#F92672"]," ",["(OAuth) defaultClient.","#F8F8F2"],["getAuthentication","#A6E22E"],["(","#F8F8F2"],["\"petstore_auth\"","#E6DB74"],[");","#F8F8F2"],"\n ",["petstore_auth.","#F8F8F2"],["setAccessToken","#A6E22E"],["(","#F8F8F2"],["\"YOUR ACCESS TOKEN\"","#E6DB74"],[");","#F8F8F2"],"\n\n ",["PetApi","#66D9EF",{"fontStyle":"italic"}]," ",["apiInstance","#F8F8F2"]," ",["= new","#F92672"]," ",["PetApi","#A6E22E"],["(defaultClient);","#F8F8F2"],"\n ",["Pet","#66D9EF",{"fontStyle":"italic"}]," ",["pet","#F8F8F2"]," ",["= new","#F92672"]," ",["Pet","#A6E22E"],["();","#F8F8F2"]," ",["// Pet | Create a new pet in the store","#88846F"],"\n ",["pet.","#F8F8F2"],["setName","#A6E22E"],["(","#F8F8F2"],["\"Snoopie\"","#E6DB74"],[");","#F8F8F2"],"\n ",["try","#F92672"]," ",["{","#F8F8F2"],"\n ",["Pet","#66D9EF",{"fontStyle":"italic"}]," ",["result","#F8F8F2"]," ",["=","#F92672"]," ",["apiInstance.","#F8F8F2"],["addPet","#A6E22E"],["(pet);","#F8F8F2"],"\n ",["System.out.","#F8F8F2"],["println","#A6E22E"],["(result);","#F8F8F2"],"\n ",["}","#F8F8F2"]," ",["catch","#F92672"]," ",["(","#F8F8F2"],["ApiException","#66D9EF",{"fontStyle":"italic"}]," ",["e","#FD971F",{"fontStyle":"italic"}],[") {","#F8F8F2"],"\n ",["System.err.","#F8F8F2"],["println","#A6E22E"],["(","#F8F8F2"],["\"Exception when calling PetApi#addPet\"","#E6DB74"],[");","#F8F8F2"],"\n ",["System.err.","#F8F8F2"],["println","#A6E22E"],["(","#F8F8F2"],["\"Status code: \"","#E6DB74"]," ",["+","#F92672"]," ",["e.","#F8F8F2"],["getCode","#A6E22E"],["());","#F8F8F2"],"\n ",["System.err.","#F8F8F2"],["println","#A6E22E"],["(","#F8F8F2"],["\"Reason: \"","#E6DB74"]," ",["+","#F92672"]," ",["e.","#F8F8F2"],["getResponseBody","#A6E22E"],["());","#F8F8F2"],"\n ",["System.err.","#F8F8F2"],["println","#A6E22E"],["(","#F8F8F2"],["\"Response headers: \"","#E6DB74"]," ",["+","#F92672"]," ",["e.","#F8F8F2"],["getResponseHeaders","#A6E22E"],["());","#F8F8F2"],"\n ",["e.","#F8F8F2"],["printStackTrace","#A6E22E"],["();","#F8F8F2"],"\n ",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["The OpenAPI Generator SDK focuses on manual serialization and deserialization using Gson, providing setter methods for individual properties of the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The two SDKs have distinctly different approaches to handling object creation, validation, and JSON serialization, with the Speakeasy-generated SDK emphasizing fluid and declarative object creation using modern patterns and annotations for handling JSON data."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Let’s look more closely at how the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," model attributes are declared in each SDK."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Notice how the Speakeasy SDK uses Jackson annotations for the JSON serialization and deserialization of objects."}],"\n",["$","$L27",null,{"codeblock":{"value":"public class Pet {\n @JsonInclude(Include.NON_ABSENT)\n @JsonProperty(\"id\")\n @SpeakeasyMetadata(\"form:name=id\")\n private Optional id;\n\n @JsonProperty(\"name\")\n @SpeakeasyMetadata(\"form:name=name\")\n private String name;\n\n @JsonInclude(Include.NON_ABSENT)\n @JsonProperty(\"category\")\n @SpeakeasyMetadata(\"form:name=x\")\n private Optional category;\n\n @JsonProperty(\"photoUrls\")\n @SpeakeasyMetadata(\"form:name=photoUrls\")\n private java.util.List photoUrls;\n\n //Rest of Pet.java ....","lang":"java","meta":"","code":"public class Pet {\n @JsonInclude(Include.NON_ABSENT)\n @JsonProperty(\"id\")\n @SpeakeasyMetadata(\"form:name=id\")\n private Optional id;\n\n @JsonProperty(\"name\")\n @SpeakeasyMetadata(\"form:name=name\")\n private String name;\n\n @JsonInclude(Include.NON_ABSENT)\n @JsonProperty(\"category\")\n @SpeakeasyMetadata(\"form:name=x\")\n private Optional category;\n\n @JsonProperty(\"photoUrls\")\n @SpeakeasyMetadata(\"form:name=photoUrls\")\n private java.util.List photoUrls;\n\n //Rest of Pet.java ....","tokens":[["public class","#F92672"]," ",["Pet","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonInclude","#66D9EF",{"fontStyle":"italic"}],["(Include.NON_ABSENT)","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"id\"","#E6DB74"],[")","#F8F8F2"],"\n ",["@","#F8F8F2"],["SpeakeasyMetadata","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"form:name=id\"","#E6DB74"],[")","#F8F8F2"],"\n ",["private","#F92672"]," ",["Optional","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["?","#66D9EF",{"fontStyle":"italic"}]," ",["extends","#F92672"]," ",["Long","#66D9EF",{"fontStyle":"italic"}],["> id;","#F8F8F2"],"\n\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"name\"","#E6DB74"],[")","#F8F8F2"],"\n ",["@","#F8F8F2"],["SpeakeasyMetadata","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"form:name=name\"","#E6DB74"],[")","#F8F8F2"],"\n ",["private","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["name;","#F8F8F2"],"\n\n ",["@","#F8F8F2"],["JsonInclude","#66D9EF",{"fontStyle":"italic"}],["(Include.NON_ABSENT)","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"category\"","#E6DB74"],[")","#F8F8F2"],"\n ",["@","#F8F8F2"],["SpeakeasyMetadata","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"form:name=x\"","#E6DB74"],[")","#F8F8F2"],"\n ",["private","#F92672"]," ",["Optional","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["?","#66D9EF",{"fontStyle":"italic"}]," ",["extends","#F92672"]," ",["Category","#66D9EF",{"fontStyle":"italic"}],["> category;","#F8F8F2"],"\n\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"photoUrls\"","#E6DB74"],[")","#F8F8F2"],"\n ",["@","#F8F8F2"],["SpeakeasyMetadata","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"form:name=photoUrls\"","#E6DB74"],[")","#F8F8F2"],"\n ",["private","#F92672"]," ",["java","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["util","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["List","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["String","#66D9EF",{"fontStyle":"italic"}],["> photoUrls;","#F8F8F2"],"\n\n ",["//Rest of Pet.java ....","#88846F"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Compare this to the OpenAPI Generator SDK ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," model that uses Gson annotations:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"public class Pet {\n public static final String SERIALIZED_NAME_ID = \"id\";\n @SerializedName(SERIALIZED_NAME_ID)\n private Long id;\n\n public static final String SERIALIZED_NAME_NAME = \"name\";\n @SerializedName(SERIALIZED_NAME_NAME)\n private String name;\n\n public static final String SERIALIZED_NAME_CATEGORY = \"category\";\n @SerializedName(SERIALIZED_NAME_CATEGORY)\n private Category category;\n\n public static final String SERIALIZED_NAME_PHOTO_URLS = \"photoUrls\";\n @SerializedName(SERIALIZED_NAME_PHOTO_URLS)\n private List photoUrls = new ArrayList<>();\n\n //Rest of Pet.java ....","lang":"java","meta":"","code":"public class Pet {\n public static final String SERIALIZED_NAME_ID = \"id\";\n @SerializedName(SERIALIZED_NAME_ID)\n private Long id;\n\n public static final String SERIALIZED_NAME_NAME = \"name\";\n @SerializedName(SERIALIZED_NAME_NAME)\n private String name;\n\n public static final String SERIALIZED_NAME_CATEGORY = \"category\";\n @SerializedName(SERIALIZED_NAME_CATEGORY)\n private Category category;\n\n public static final String SERIALIZED_NAME_PHOTO_URLS = \"photoUrls\";\n @SerializedName(SERIALIZED_NAME_PHOTO_URLS)\n private List photoUrls = new ArrayList<>();\n\n //Rest of Pet.java ....","tokens":[["public class","#F92672"]," ",["Pet","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["public static final","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["SERIALIZED_NAME_ID","#F8F8F2"]," ",["=","#F92672"]," ",["\"id\"","#E6DB74"],[";","#F8F8F2"],"\n ",["@","#F8F8F2"],["SerializedName","#66D9EF",{"fontStyle":"italic"}],["(SERIALIZED_NAME_ID)","#F8F8F2"],"\n ",["private","#F92672"]," ",["Long","#66D9EF",{"fontStyle":"italic"}]," ",["id;","#F8F8F2"],"\n\n ",["public static final","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["SERIALIZED_NAME_NAME","#F8F8F2"]," ",["=","#F92672"]," ",["\"name\"","#E6DB74"],[";","#F8F8F2"],"\n ",["@","#F8F8F2"],["SerializedName","#66D9EF",{"fontStyle":"italic"}],["(SERIALIZED_NAME_NAME)","#F8F8F2"],"\n ",["private","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["name;","#F8F8F2"],"\n\n ",["public static final","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["SERIALIZED_NAME_CATEGORY","#F8F8F2"]," ",["=","#F92672"]," ",["\"category\"","#E6DB74"],[";","#F8F8F2"],"\n ",["@","#F8F8F2"],["SerializedName","#66D9EF",{"fontStyle":"italic"}],["(SERIALIZED_NAME_CATEGORY)","#F8F8F2"],"\n ",["private","#F92672"]," ",["Category","#66D9EF",{"fontStyle":"italic"}]," ",["category;","#F8F8F2"],"\n\n ",["public static final","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["SERIALIZED_NAME_PHOTO_URLS","#F8F8F2"]," ",["=","#F92672"]," ",["\"photoUrls\"","#E6DB74"],[";","#F8F8F2"],"\n ",["@","#F8F8F2"],["SerializedName","#66D9EF",{"fontStyle":"italic"}],["(SERIALIZED_NAME_PHOTO_URLS)","#F8F8F2"],"\n ",["private","#F92672"]," ",["List","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["String","#66D9EF",{"fontStyle":"italic"}],["> photoUrls","#F8F8F2"]," ",["= new","#F92672"]," ",["ArrayList","#66D9EF",{"fontStyle":"italic"}],["<>();","#F8F8F2"],"\n\n ",["//Rest of Pet.java ....","#88846F"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Let’s take a moment and identify what the differences are between the Jackson vs GSON libraries and what features each has."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The Gson JSON library is easy to use and implement and well-suited to smaller projects. It provides an API for JSON support but doesn’t support extensive configuration options."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"On the other hand, Jackson is designed to be more configurable and flexible when it comes to JSON serialization and deserialization. Jackson is the standard JSON-support library in many popular Java frameworks (like Spring, Jersey, and RESTEasy), it’s widely used in the Java community, and it’s actively supported and frequently updated. Jackson is also generally faster and offers extensive configuration options."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The use of the Jackson library in the Speakeasy-generated SDK provides us with a firm foundation for building fast and scalable applications."}],"\n",["$","h2",null,{"id":"http-communication","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["HTTP communication",["$","$L26",null,{"id":"http-communication"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Java 11 (the minimum version supported by Speakeasy) significantly improved HTTP communication with the java.net.http package providing a powerful ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"HTTPClient"}]," class for enhanced HTTP communication."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Given the OpenAPI Generator SDK is Java 8 compatible, we suspected it might use some third-party libraries. On inspection, our suspicions were confirmed: The SDK uses a third-party library to handle HTTP communication."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Take a look at the following method to add a new ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object (from the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"PetApi.java"}]," file):"]}],"\n",["$","$L27",null,{"codeblock":{"value":" public Pet addPet(Pet pet) throws ApiException {\n ApiResponse localVarResp = addPetWithHttpInfo(pet);\n return localVarResp.getData();\n }","lang":"java","meta":"","code":" public Pet addPet(Pet pet) throws ApiException {\n ApiResponse localVarResp = addPetWithHttpInfo(pet);\n return localVarResp.getData();\n }","tokens":[" ",["public","#F92672"]," ",["Pet","#66D9EF",{"fontStyle":"italic"}]," ",["addPet","#A6E22E"],["(","#F8F8F2"],["Pet","#66D9EF",{"fontStyle":"italic"}]," ",["pet) throws ApiException {","#F8F8F2"],"\n ",["ApiResponse","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["Pet","#66D9EF",{"fontStyle":"italic"}],["> localVarResp","#F8F8F2"]," ",["=","#F92672"]," ",["addPetWithHttpInfo","#A6E22E"],["(pet);","#F8F8F2"],"\n ",["return","#F92672"]," ",["localVarResp.","#F8F8F2"],["getData","#A6E22E"],["();","#F8F8F2"],"\n ",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["The ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"addPet"}]," method in turn calls the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"addPetWithHttpInfo(pet)"}]," method:"]}],"\n",["$","$L27",null,{"codeblock":{"value":" public ApiResponse addPetWithHttpInfo(Pet pet) throws ApiException {\n okhttp3.Call localVarCall = addPetValidateBeforeCall(pet, null);\n Type localVarReturnType = new TypeToken(){}.getType();\n return localVarApiClient.execute(localVarCall, localVarReturnType);\n }","lang":"java","meta":"","code":" public ApiResponse addPetWithHttpInfo(Pet pet) throws ApiException {\n okhttp3.Call localVarCall = addPetValidateBeforeCall(pet, null);\n Type localVarReturnType = new TypeToken(){}.getType();\n return localVarApiClient.execute(localVarCall, localVarReturnType);\n }","tokens":[" ",["public","#F92672"]," ",["ApiResponse","#66D9EF",{"fontStyle":"italic"}],["<","#F92672"],["Pet","#F8F8F2"],[">","#F92672"]," ",["addPetWithHttpInfo","#A6E22E"],["(","#F8F8F2"],["Pet","#66D9EF",{"fontStyle":"italic"}]," ",["pet) throws ApiException {","#F8F8F2"],"\n ",["okhttp3","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["Call","#66D9EF",{"fontStyle":"italic"}]," ",["localVarCall","#F8F8F2"]," ",["=","#F92672"]," ",["addPetValidateBeforeCall","#A6E22E"],["(pet,","#F8F8F2"]," ",["null","#AE81FF"],[");","#F8F8F2"],"\n ",["Type","#66D9EF",{"fontStyle":"italic"}]," ",["localVarReturnType","#F8F8F2"]," ",["= new","#F92672"]," ",["TypeToken","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["Pet","#66D9EF",{"fontStyle":"italic"}],[">(){}.","#F8F8F2"],["getType","#A6E22E"],["();","#F8F8F2"],"\n ",["return","#F92672"]," ",["localVarApiClient.","#F8F8F2"],["execute","#A6E22E"],["(localVarCall, localVarReturnType);","#F8F8F2"],"\n ",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Note how the method uses the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"okhttp3.Call"}]," object."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["We examined the dependencies configured in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"build.gradle"}]," file and discovered the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"okhttp"}]," dependency:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"implementation 'com.squareup.okhttp3:okhttp:4.10.0'","lang":"groovy","meta":"","code":"implementation 'com.squareup.okhttp3:okhttp:4.10.0'","tokens":[["implementation","#F8F8F2"]," ",["'com.squareup.okhttp3:okhttp:4.10.0'","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Having established that the OpenAPI Generator SDK uses the OkHttp library, we were curious to see how the Speakeasy-generated SDK handles HTTP communication."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Take a look at this extract from the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"addPetJson"}]," method in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet.java"}]," file of the Speakeasy SDK:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"HTTPRequest req = new HTTPRequest();\nreq.setMethod(\"POST\");\nreq.setURL(url);\nObject _convertedRequest = Utils.convertToShape(request, Utils.JsonShape.DEFAULT,\n new TypeReference() {});\nSerializedBody serializedRequestBody = org.openapis.openapi.utils.Utils.serializeRequestBody(\n _convertedRequest, \"request\", \"json\", false);\nif (serializedRequestBody == null) {\n throw new Exception(\"Request body is required\");\n}\nreq.setBody(serializedRequestBody);\n\nreq.addHeader(\"Accept\", \"application/json;q=1, application/xml;q=0\");\nreq.addHeader(\"user-agent\", this.sdkConfiguration.userAgent);\n\nHTTPClient client = org.openapis.openapi.utils.Utils.configureSecurityClient(\n this.sdkConfiguration.defaultClient, this.sdkConfiguration.securitySource.getSecurity());\n\nHttpResponse httpRes = client.send(req);","lang":"java","meta":"","code":"HTTPRequest req = new HTTPRequest();\nreq.setMethod(\"POST\");\nreq.setURL(url);\nObject _convertedRequest = Utils.convertToShape(request, Utils.JsonShape.DEFAULT,\n new TypeReference() {});\nSerializedBody serializedRequestBody = org.openapis.openapi.utils.Utils.serializeRequestBody(\n _convertedRequest, \"request\", \"json\", false);\nif (serializedRequestBody == null) {\n throw new Exception(\"Request body is required\");\n}\nreq.setBody(serializedRequestBody);\n\nreq.addHeader(\"Accept\", \"application/json;q=1, application/xml;q=0\");\nreq.addHeader(\"user-agent\", this.sdkConfiguration.userAgent);\n\nHTTPClient client = org.openapis.openapi.utils.Utils.configureSecurityClient(\n this.sdkConfiguration.defaultClient, this.sdkConfiguration.securitySource.getSecurity());\n\nHttpResponse httpRes = client.send(req);","tokens":[["HTTPRequest","#66D9EF",{"fontStyle":"italic"}]," ",["req","#F8F8F2"]," ",["= new","#F92672"]," ",["HTTPRequest","#A6E22E"],["();","#F8F8F2"],"\n",["req.","#F8F8F2"],["setMethod","#A6E22E"],["(","#F8F8F2"],["\"POST\"","#E6DB74"],[");","#F8F8F2"],"\n",["req.","#F8F8F2"],["setURL","#A6E22E"],["(url);","#F8F8F2"],"\n",["Object","#66D9EF",{"fontStyle":"italic"}]," ",["_convertedRequest","#F8F8F2"]," ",["=","#F92672"]," ",["Utils.","#F8F8F2"],["convertToShape","#A6E22E"],["(request, Utils.JsonShape.DEFAULT,","#F8F8F2"],"\n ",["new","#F92672"]," ",["TypeReference","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["org","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["openapis","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["openapi","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["models","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["components","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["Pet","#66D9EF",{"fontStyle":"italic"}],[">() {});","#F8F8F2"],"\n",["SerializedBody","#66D9EF",{"fontStyle":"italic"}]," ",["serializedRequestBody","#F8F8F2"]," ",["=","#F92672"]," ",["org.openapis.openapi.utils.Utils.","#F8F8F2"],["serializeRequestBody","#A6E22E"],["(","#F8F8F2"],"\n ",["_convertedRequest,","#F8F8F2"]," ",["\"request\"","#E6DB74"],[",","#F8F8F2"]," ",["\"json\"","#E6DB74"],[",","#F8F8F2"]," ",["false","#AE81FF"],[");","#F8F8F2"],"\n",["if","#F92672"]," ",["(serializedRequestBody","#F8F8F2"]," ",["==","#F92672"]," ",["null","#AE81FF"],[") {","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Exception","#A6E22E"],["(","#F8F8F2"],["\"Request body is required\"","#E6DB74"],[");","#F8F8F2"],"\n",["}","#F8F8F2"],"\n",["req.","#F8F8F2"],["setBody","#A6E22E"],["(serializedRequestBody);","#F8F8F2"],"\n\n",["req.","#F8F8F2"],["addHeader","#A6E22E"],["(","#F8F8F2"],["\"Accept\"","#E6DB74"],[",","#F8F8F2"]," ",["\"application/json;q=1, application/xml;q=0\"","#E6DB74"],[");","#F8F8F2"],"\n",["req.","#F8F8F2"],["addHeader","#A6E22E"],["(","#F8F8F2"],["\"user-agent\"","#E6DB74"],[",","#F8F8F2"]," ",["this","#FD971F"],[".sdkConfiguration.userAgent);","#F8F8F2"],"\n\n",["HTTPClient","#66D9EF",{"fontStyle":"italic"}]," ",["client","#F8F8F2"]," ",["=","#F92672"]," ",["org.openapis.openapi.utils.Utils.","#F8F8F2"],["configureSecurityClient","#A6E22E"],["(","#F8F8F2"],"\n ",["this","#FD971F"],[".sdkConfiguration.defaultClient,","#F8F8F2"]," ",["this","#FD971F"],[".sdkConfiguration.securitySource.","#F8F8F2"],["getSecurity","#A6E22E"],["());","#F8F8F2"],"\n\n",["HttpResponse","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["InputStream","#66D9EF",{"fontStyle":"italic"}],["> httpRes","#F8F8F2"]," ",["=","#F92672"]," ",["client.","#F8F8F2"],["send","#A6E22E"],["(req);","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["This method uses ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"HTTPClient"}],", ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"HTTPRequest"}],", and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"HTTPResponse"}]," objects. If we look at the import statements, we can see that these objects are generated from the following classes:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"import org.openapis.openapi.utils.HTTPClient;\nimport org.openapis.openapi.utils.HTTPRequest;\nimport java.net.http.HttpResponse;","lang":"java","meta":"","code":"import org.openapis.openapi.utils.HTTPClient;\nimport org.openapis.openapi.utils.HTTPRequest;\nimport java.net.http.HttpResponse;","tokens":[["import org.openapis.openapi.utils.HTTPClient","#F92672"],[";","#F8F8F2"],"\n",["import org.openapis.openapi.utils.HTTPRequest","#F92672"],[";","#F8F8F2"],"\n",["import java.net.http.HttpResponse","#F92672"],[";","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["The ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"HTTPClient"}]," and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"HTTPRequest"}]," interfaces are both generated by Speakeasy."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["We can see the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"HTTPClient"}]," interface implemented in ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"SpeakeasyHTTPClient.java"}]," to establish the HTTP communication method:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"import org.openapis.openapi.utils.HTTPClient;\n\nimport java.io.IOException;\nimport java.net.URISyntaxException;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.io.InputStream;\n\npublic class SpeakeasyHTTPClient implements HTTPClient {\n\n @Override\n public HttpResponse send(HttpRequest request)\n throws IOException, InterruptedException, URISyntaxException {\n HttpClient client = HttpClient.newHttpClient();\n return client.send(request, HttpResponse.BodyHandlers.ofInputStream());\n }\n}","lang":"java","meta":"","code":"import org.openapis.openapi.utils.HTTPClient;\n\nimport java.io.IOException;\nimport java.net.URISyntaxException;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.io.InputStream;\n\npublic class SpeakeasyHTTPClient implements HTTPClient {\n\n @Override\n public HttpResponse send(HttpRequest request)\n throws IOException, InterruptedException, URISyntaxException {\n HttpClient client = HttpClient.newHttpClient();\n return client.send(request, HttpResponse.BodyHandlers.ofInputStream());\n }\n}","tokens":[["import org.openapis.openapi.utils.HTTPClient","#F92672"],[";","#F8F8F2"],"\n\n",["import java.io.IOException","#F92672"],[";","#F8F8F2"],"\n",["import java.net.URISyntaxException","#F92672"],[";","#F8F8F2"],"\n",["import java.net.http.HttpClient","#F92672"],[";","#F8F8F2"],"\n",["import java.net.http.HttpRequest","#F92672"],[";","#F8F8F2"],"\n",["import java.net.http.HttpResponse","#F92672"],[";","#F8F8F2"],"\n",["import java.io.InputStream","#F92672"],[";","#F8F8F2"],"\n\n",["public class","#F92672"]," ",["SpeakeasyHTTPClient","#A6E22E",{"textDecoration":"underline"}]," ",["implements","#F92672"]," ",["HTTPClient","#A6E22E",{"fontStyle":"italic","textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n\n ",["@","#F8F8F2"],["Override","#66D9EF",{"fontStyle":"italic"}],"\n ",["public","#F92672"]," ",["HttpResponse","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["InputStream","#66D9EF",{"fontStyle":"italic"}],[">","#F8F8F2"]," ",["send","#A6E22E"],["(","#F8F8F2"],["HttpRequest","#66D9EF",{"fontStyle":"italic"}]," ",["request","#FD971F",{"fontStyle":"italic"}],[")","#F8F8F2"],"\n ",["throws","#F92672"]," ",["IOException","#66D9EF",{"fontStyle":"italic"}],[",","#F8F8F2"]," ",["InterruptedException","#66D9EF",{"fontStyle":"italic"}],[",","#F8F8F2"]," ",["URISyntaxException","#66D9EF",{"fontStyle":"italic"}]," ",["{","#F8F8F2"],"\n ",["HttpClient","#66D9EF",{"fontStyle":"italic"}]," ",["client","#F8F8F2"]," ",["=","#F92672"]," ",["HttpClient.","#F8F8F2"],["newHttpClient","#A6E22E"],["();","#F8F8F2"],"\n ",["return","#F92672"]," ",["client.","#F8F8F2"],["send","#A6E22E"],["(request, HttpResponse.BodyHandlers.","#F8F8F2"],["ofInputStream","#A6E22E"],["());","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The Speakeasy SDK uses the Java HTTP APIs that were introduced in Java 11. Some of the benefits of using the built-in Java HTTP APIs are:"}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Standardization:"}]," By using the HTTP Client API supported in Java 11, the SDK uses the standards provided and supported by modern Java SDK providers. The ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"HttpClient"}]," class integrates more easily with the other Java APIs in the Java SDK."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Asynchronous support:"}]," Asynchronous HTTP communication is not available in Java 8, making it harder to build scalable applications. The HTTP Client API asynchronous HTTP communication available in Java 11 provides a CompletableFuture object immediately after calling the API, which gives developers more control."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Performance and efficiency:"}]," The HTTP Client is created using a builder and allows for configuring client-specific settings, such as the preferred protocol version (HTTP/1.1 or HTTP/2). It also supports Observable APIs."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Security, stability, and long-term support:"}]," As a standard Java API, the HTTP Client is more stable and secure, and benefits from the long-term support cycles of new Java versions."]}],"\n"]}],"\n",["$","h2",null,{"id":"retries","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Retries",["$","$L26",null,{"id":"retries"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The SDK created by Speakeasy can automatically retry requests."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["You can enable retries globally or per request using the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"x-speakeasy-retries"}]," extension in your OpenAPI specification document."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Let’s add the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"x-speakeasy-retries"}]," extension to the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"addPet"}]," method in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"petstore.yaml"}]," file:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"# ...\npaths:\n /pet:\n # ...\n post:\n #...\n operationId: addPet\n x-speakeasy-retries:\n strategy: backoff\n backoff:\n initialInterval: 500 # 500 milliseconds\n maxInterval: 60000 # 60 seconds\n maxElapsedTime: 3600000 # 5 minutes\n exponent: 1.5\n statusCodes:\n - 5XX\n retryConnectionErrors: true","lang":"yaml","meta":"","code":"# ...\npaths:\n /pet:\n # ...\n post:\n #...\n operationId: addPet\n x-speakeasy-retries:\n strategy: backoff\n backoff:\n initialInterval: 500 # 500 milliseconds\n maxInterval: 60000 # 60 seconds\n maxElapsedTime: 3600000 # 5 minutes\n exponent: 1.5\n statusCodes:\n - 5XX\n retryConnectionErrors: true","tokens":[["# ...","#88846F"],"\n",["paths","#F92672"],[":","#F8F8F2"],"\n ",["/pet","#F92672"],[":","#F8F8F2"],"\n ",["# ...","#88846F"],"\n ",["post","#F92672"],[":","#F8F8F2"],"\n ",["#...","#88846F"],"\n ",["operationId","#F92672"],[":","#F8F8F2"]," ",["addPet","#E6DB74"],"\n ",["x-speakeasy-retries","#F92672"],[":","#F8F8F2"],"\n ",["strategy","#F92672"],[":","#F8F8F2"]," ",["backoff","#E6DB74"],"\n ",["backoff","#F92672"],[":","#F8F8F2"],"\n ",["initialInterval","#F92672"],[":","#F8F8F2"]," ",["500","#AE81FF"]," ",["# 500 milliseconds","#88846F"],"\n ",["maxInterval","#F92672"],[":","#F8F8F2"]," ",["60000","#AE81FF"]," ",["# 60 seconds","#88846F"],"\n ",["maxElapsedTime","#F92672"],[":","#F8F8F2"]," ",["3600000","#AE81FF"]," ",["# 5 minutes","#88846F"],"\n ",["exponent","#F92672"],[":","#F8F8F2"]," ",["1.5","#AE81FF"],"\n ",["statusCodes","#F92672"],[":","#F8F8F2"],"\n ",["-","#F8F8F2"]," ",["5XX","#E6DB74"],"\n ",["retryConnectionErrors","#F92672"],[":","#F8F8F2"]," ",["true","#AE81FF"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"If you re-generate the SDK now, the new retry configuration will be included."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["For more information on configuring retries in your SDK, take a look at the ",["$","$L25",null,{"href":"/docs/customize-sdks/retries","prefetch":"$undefined","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":"retries documentation"}],"."]}],"\n",["$","h2",null,{"id":"sdk-dependencies","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["SDK dependencies",["$","$L26",null,{"id":"sdk-dependencies"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Let’s compare dependencies in the two SDKs."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Here are the OpenAPI Generator SDK dependencies in ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"build.gradle"}],":"]}],"\n",["$","$L27",null,{"codeblock":{"value":"implementation 'io.swagger:swagger-annotations:1.6.8'\nimplementation \"com.google.code.findbugs:jsr305:3.0.2\"\nimplementation 'com.squareup.okhttp3:okhttp:4.10.0'\nimplementation 'com.squareup.okhttp3:logging-interceptor:4.10.0'\nimplementation 'com.google.code.gson:gson:2.9.1'\nimplementation 'io.gsonfire:gson-fire:1.9.0'\nimplementation 'javax.ws.rs:jsr311-api:1.1.1'\nimplementation 'javax.ws.rs:javax.ws.rs-api:2.1.1'\nimplementation 'org.openapitools:jackson-databind-nullable:0.2.6'\nimplementation group: 'org.apache.oltu.oauth2', name: 'org.apache.oltu.oauth2.client', version: '1.0.2'\nimplementation group: 'org.apache.commons', name: 'commons-lang3', version: '3.12.0'\nimplementation \"jakarta.annotation:jakarta.annotation-api:$jakarta_annotation_version\"\ntestImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.1'\ntestImplementation 'org.mockito:mockito-core:3.12.4'\ntestRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.1'","lang":"groovy","meta":"","code":"implementation 'io.swagger:swagger-annotations:1.6.8'\nimplementation \"com.google.code.findbugs:jsr305:3.0.2\"\nimplementation 'com.squareup.okhttp3:okhttp:4.10.0'\nimplementation 'com.squareup.okhttp3:logging-interceptor:4.10.0'\nimplementation 'com.google.code.gson:gson:2.9.1'\nimplementation 'io.gsonfire:gson-fire:1.9.0'\nimplementation 'javax.ws.rs:jsr311-api:1.1.1'\nimplementation 'javax.ws.rs:javax.ws.rs-api:2.1.1'\nimplementation 'org.openapitools:jackson-databind-nullable:0.2.6'\nimplementation group: 'org.apache.oltu.oauth2', name: 'org.apache.oltu.oauth2.client', version: '1.0.2'\nimplementation group: 'org.apache.commons', name: 'commons-lang3', version: '3.12.0'\nimplementation \"jakarta.annotation:jakarta.annotation-api:$jakarta_annotation_version\"\ntestImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.1'\ntestImplementation 'org.mockito:mockito-core:3.12.4'\ntestRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.1'","tokens":[["implementation","#F8F8F2"]," ",["'io.swagger:swagger-annotations:1.6.8'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["\"com.google.code.findbugs:jsr305:3.0.2\"","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["'com.squareup.okhttp3:okhttp:4.10.0'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["'com.squareup.okhttp3:logging-interceptor:4.10.0'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["'com.google.code.gson:gson:2.9.1'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["'io.gsonfire:gson-fire:1.9.0'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["'javax.ws.rs:jsr311-api:1.1.1'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["'javax.ws.rs:javax.ws.rs-api:2.1.1'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["'org.openapitools:jackson-databind-nullable:0.2.6'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["group","#AE81FF"],[":","#F8F8F2"]," ",["'org.apache.oltu.oauth2'","#E6DB74"],[",","#F8F8F2"]," ",["name","#AE81FF"],[":","#F8F8F2"]," ",["'org.apache.oltu.oauth2.client'","#E6DB74"],[",","#F8F8F2"]," ",["version","#AE81FF"],[":","#F8F8F2"]," ",["'1.0.2'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["group","#AE81FF"],[":","#F8F8F2"]," ",["'org.apache.commons'","#E6DB74"],[",","#F8F8F2"]," ",["name","#AE81FF"],[":","#F8F8F2"]," ",["'commons-lang3'","#E6DB74"],[",","#F8F8F2"]," ",["version","#AE81FF"],[":","#F8F8F2"]," ",["'3.12.0'","#E6DB74"],"\n",["implementation","#F8F8F2"]," ",["\"jakarta.annotation:jakarta.annotation-api:","#E6DB74"],["$$jakarta_annotation_version","#F8F8F2"],["\"","#E6DB74"],"\n",["testImplementation","#F8F8F2"]," ",["'org.junit.jupiter:junit-jupiter-api:5.9.1'","#E6DB74"],"\n",["testImplementation","#F8F8F2"]," ",["'org.mockito:mockito-core:3.12.4'","#E6DB74"],"\n",["testRuntimeOnly","#F8F8F2"]," ",["'org.junit.jupiter:junit-jupiter-engine:5.9.1'","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Here are the Speakeasy SDK dependencies from ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"build.gradle"}],":"]}],"\n",["$","$L27",null,{"codeblock":{"value":"implementation 'com.fasterxml.jackson.core:jackson-databind:2.16.2'\nimplementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.16.2'\nimplementation 'com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.16.2'\nimplementation 'org.openapitools:jackson-databind-nullable:0.2.6'\nimplementation 'org.apache.httpcomponents:httpclient:4.5.14'\nimplementation 'org.apache.httpcomponents:httpmime:4.5.14'\nimplementation 'com.jayway.jsonpath:json-path:2.9.0'\nimplementation 'commons-io:commons-io:2.15.1'","lang":"txt","meta":"","code":"implementation 'com.fasterxml.jackson.core:jackson-databind:2.16.2'\nimplementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.16.2'\nimplementation 'com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.16.2'\nimplementation 'org.openapitools:jackson-databind-nullable:0.2.6'\nimplementation 'org.apache.httpcomponents:httpclient:4.5.14'\nimplementation 'org.apache.httpcomponents:httpmime:4.5.14'\nimplementation 'com.jayway.jsonpath:json-path:2.9.0'\nimplementation 'commons-io:commons-io:2.15.1'","tokens":[["implementation 'com.fasterxml.jackson.core:jackson-databind:2.16.2'","#F8F8F2"],"\n",["implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.16.2'","#F8F8F2"],"\n",["implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.16.2'","#F8F8F2"],"\n",["implementation 'org.openapitools:jackson-databind-nullable:0.2.6'","#F8F8F2"],"\n",["implementation 'org.apache.httpcomponents:httpclient:4.5.14'","#F8F8F2"],"\n",["implementation 'org.apache.httpcomponents:httpmime:4.5.14'","#F8F8F2"],"\n",["implementation 'com.jayway.jsonpath:json-path:2.9.0'","#F8F8F2"],"\n",["implementation 'commons-io:commons-io:2.15.1'","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The OpenAPI Generator SDK implements more libraries than the Speakeasy SDK, possibly due to the compatibility requirements and limitations of Java 8. Depending on fewer third-party implementations provides the Speakeasy SDK with some advantages:"}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Less maintenance:"}]," Projects with fewer dependencies have a lower maintenance overhead and less versioning to keep track of long term."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Reduced risk of dependency-related issues:"}]," Third-party dependencies increase the risk of bugs and security failures that depend on the third-party provider to fix. A security flaw in a third-party dependency makes your application vulnerable."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Improved performance:"}]," Code generally works better in standard Java APIs as they have been through rigorous testing and QA cycles before being made available to the public."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Easier adoption:"}]," Projects tend to more readily accept SDK builds that rely on fewer third-party dependencies, due to strict policies regarding the use and management of these dependencies."]}],"\n"]}],"\n",["$","h2",null,{"id":"handling-non-nullable-fields","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Handling non-nullable fields",["$","$L26",null,{"id":"handling-non-nullable-fields"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Let’s see how Speakeasy’s enhanced null safety and Optional support work on fields in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Take a look at the following declaration taken from the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object in the Speakeasy SDK ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"org.openapis.openapi.models.components.Pet.java"}]," file:"]}],"\n",["$","$L27",null,{"codeblock":{"value":" @JsonInclude(Include.NON_ABSENT)\n @JsonProperty(\"status\")\n @SpeakeasyMetadata(\"form:name=status\")\n private Optional status;","lang":"java","meta":"","code":" @JsonInclude(Include.NON_ABSENT)\n @JsonProperty(\"status\")\n @SpeakeasyMetadata(\"form:name=status\")\n private Optional status;","tokens":[" ",["@","#F8F8F2"],["JsonInclude","#66D9EF",{"fontStyle":"italic"}],["(Include.NON_ABSENT)","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"status\"","#E6DB74"],[")","#F8F8F2"],"\n ",["@","#F8F8F2"],["SpeakeasyMetadata","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"form:name=status\"","#E6DB74"],[")","#F8F8F2"],"\n ",["private","#F92672"]," ",["Optional","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["?","#66D9EF",{"fontStyle":"italic"}]," ",["extends","#F92672"]," ",["Status","#66D9EF",{"fontStyle":"italic"}],["> status;","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Note that the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"@JsonInclude"}]," annotation indicates it is ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"NON-ABSENT"}]," and the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Optional"}]," class is used. The status field here is an enum (",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Status"}],") wrapped in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Optional"}]," class."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Let’s examine the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Status"}]," enum object:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"public enum Status {\n AVAILABLE(\"available\"),\n PENDING(\"pending\"),\n SOLD(\"sold\");\n\n @JsonValue\n private final String value;\n\n private Status(String value) {\n this.value = value;\n }\n\n public String value() {\n return value;\n }\n}","lang":"java","meta":"","code":"public enum Status {\n AVAILABLE(\"available\"),\n PENDING(\"pending\"),\n SOLD(\"sold\");\n\n @JsonValue\n private final String value;\n\n private Status(String value) {\n this.value = value;\n }\n\n public String value() {\n return value;\n }\n}","tokens":[["public enum","#F92672"]," ",["Status","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["AVAILABLE","#AE81FF"],["(","#F8F8F2"],["\"available\"","#E6DB74"],["),","#F8F8F2"],"\n ",["PENDING","#AE81FF"],["(","#F8F8F2"],["\"pending\"","#E6DB74"],["),","#F8F8F2"],"\n ",["SOLD","#AE81FF"],["(","#F8F8F2"],["\"sold\"","#E6DB74"],[");","#F8F8F2"],"\n\n ",["@","#F8F8F2"],["JsonValue","#66D9EF",{"fontStyle":"italic"}],"\n ",["private final","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["value;","#F8F8F2"],"\n\n ",["private","#F92672"]," ",["Status","#A6E22E"],["(","#F8F8F2"],["String","#66D9EF",{"fontStyle":"italic"}]," ",["value","#FD971F",{"fontStyle":"italic"}],[") {","#F8F8F2"],"\n ",["this","#FD971F"],[".value","#F8F8F2"]," ",["=","#F92672"]," ",["value;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["public","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["value","#A6E22E"],["() {","#F8F8F2"],"\n ",["return","#F92672"]," ",["value;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Let’s compare the Speakeasy SDK ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"status"}]," field declaration to the same field in the OpenAPI Generator SDK. The following declaration is taken from the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"org.openapitools.client.model.Pet.java"}]," file:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"$30","lang":"java","meta":"","code":"$31","tokens":[["public enum","#F92672"]," ",["StatusEnum","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["AVAILABLE","#AE81FF"],["(","#F8F8F2"],["\"available\"","#E6DB74"],["),","#F8F8F2"],"\n\n ",["PENDING","#AE81FF"],["(","#F8F8F2"],["\"pending\"","#E6DB74"],["),","#F8F8F2"],"\n\n ",["SOLD","#AE81FF"],["(","#F8F8F2"],["\"sold\"","#E6DB74"],[");","#F8F8F2"],"\n\n ",["private","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["value;","#F8F8F2"],"\n\n ",["StatusEnum","#A6E22E"],["(","#F8F8F2"],["String","#66D9EF",{"fontStyle":"italic"}]," ",["value","#FD971F",{"fontStyle":"italic"}],[") {","#F8F8F2"],"\n ",["this","#FD971F"],[".value","#F8F8F2"]," ",["=","#F92672"]," ",["value;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["public","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["getValue","#A6E22E"],["() {","#F8F8F2"],"\n ",["return","#F92672"]," ",["value;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["@","#F8F8F2"],["Override","#66D9EF",{"fontStyle":"italic"}],"\n ",["public","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["toString","#A6E22E"],["() {","#F8F8F2"],"\n ",["return","#F92672"]," ",["String.","#F8F8F2"],["valueOf","#A6E22E"],["(value);","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["public static","#F92672"]," ",["StatusEnum","#66D9EF",{"fontStyle":"italic"}]," ",["fromValue","#A6E22E"],["(","#F8F8F2"],["String","#66D9EF",{"fontStyle":"italic"}]," ",["value","#FD971F",{"fontStyle":"italic"}],[") {","#F8F8F2"],"\n ",["for","#F92672"]," ",["(","#F8F8F2"],["StatusEnum","#66D9EF",{"fontStyle":"italic"}]," ",["b","#F8F8F2"]," ",[":","#F92672"]," ",["StatusEnum.","#F8F8F2"],["values","#A6E22E"],["()) {","#F8F8F2"],"\n ",["if","#F92672"]," ",["(b.value.","#F8F8F2"],["equals","#A6E22E"],["(value)) {","#F8F8F2"],"\n ",["return","#F92672"]," ",["b;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["IllegalArgumentException","#A6E22E"],["(","#F8F8F2"],["\"Unexpected value '\"","#E6DB74"]," ",["+","#F92672"]," ",["value","#F8F8F2"]," ",["+","#F92672"]," ",["\"'\"","#E6DB74"],[");","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["public static class","#F92672"]," ",["Adapter","#A6E22E",{"textDecoration":"underline"}]," ",["extends","#F92672"]," ",["TypeAdapter","#A6E22E",{"fontStyle":"italic","textDecoration":"underline"}],["<","#F8F8F2"],["StatusEnum","#66D9EF",{"fontStyle":"italic"}],["> {","#F8F8F2"],"\n ",["@","#F8F8F2"],["Override","#66D9EF",{"fontStyle":"italic"}],"\n ",["public","#F92672"]," ",["void","#66D9EF",{"fontStyle":"italic"}]," ",["write","#A6E22E"],["(","#F8F8F2"],["final","#F92672"]," ",["JsonWriter","#66D9EF",{"fontStyle":"italic"}]," ",["jsonWriter","#FD971F",{"fontStyle":"italic"}],[",","#F8F8F2"]," ",["final","#F92672"]," ",["StatusEnum","#66D9EF",{"fontStyle":"italic"}]," ",["enumeration","#FD971F",{"fontStyle":"italic"}],[")","#F8F8F2"]," ",["throws","#F92672"]," ",["IOException","#66D9EF",{"fontStyle":"italic"}]," ",["{","#F8F8F2"],"\n ",["jsonWriter.","#F8F8F2"],["value","#A6E22E"],["(enumeration.","#F8F8F2"],["getValue","#A6E22E"],["());","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["@","#F8F8F2"],["Override","#66D9EF",{"fontStyle":"italic"}],"\n ",["public","#F92672"]," ",["StatusEnum","#66D9EF",{"fontStyle":"italic"}]," ",["read","#A6E22E"],["(","#F8F8F2"],["final","#F92672"]," ",["JsonReader","#66D9EF",{"fontStyle":"italic"}]," ",["jsonReader","#FD971F",{"fontStyle":"italic"}],[")","#F8F8F2"]," ",["throws","#F92672"]," ",["IOException","#66D9EF",{"fontStyle":"italic"}]," ",["{","#F8F8F2"],"\n ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["value","#F8F8F2"]," ",["=","#F92672"]," ",["jsonReader.","#F8F8F2"],["nextString","#A6E22E"],["();","#F8F8F2"],"\n ",["return","#F92672"]," ",["StatusEnum.","#F8F8F2"],["fromValue","#A6E22E"],["(value);","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["public static","#F92672"]," ",["void","#66D9EF",{"fontStyle":"italic"}]," ",["validateJsonElement","#A6E22E"],["(","#F8F8F2"],["JsonElement","#66D9EF",{"fontStyle":"italic"}]," ",["jsonElement","#FD971F",{"fontStyle":"italic"}],[")","#F8F8F2"]," ",["throws","#F92672"]," ",["IOException","#66D9EF",{"fontStyle":"italic"}]," ",["{","#F8F8F2"],"\n ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["value","#F8F8F2"]," ",["=","#F92672"]," ",["jsonElement.","#F8F8F2"],["getAsString","#A6E22E"],["();","#F8F8F2"],"\n ",["StatusEnum.","#F8F8F2"],["fromValue","#A6E22E"],["(value);","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["public static final","#F92672"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["SERIALIZED_NAME_STATUS","#F8F8F2"]," ",["=","#F92672"]," ",["\"status\"","#E6DB74"],[";","#F8F8F2"],"\n ",["@","#F8F8F2"],["SerializedName","#66D9EF",{"fontStyle":"italic"}],["(SERIALIZED_NAME_STATUS)","#F8F8F2"],"\n ",["private","#F92672"]," ",["StatusEnum","#66D9EF",{"fontStyle":"italic"}]," ",["status;","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["At first glance, the OpenAPI Generator SDK also uses an enum approach, representing the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"status"}]," field as an enum called ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"StatusEnum"}]," with three possible values: ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"AVAILABLE"}],", ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"PENDING"}],", and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"SOLD"}],". A lot of code is generated around this field to handle the enum, but the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object does not indicate that the OpenAPI Generator SDK ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"status"}]," field is non-nullable at this point."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["In contrast, Speakeasy uses a direct approach to non-nullable fields. The Speakeasy SDK also uses a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Status"}]," enum for the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"status"}]," field, but it is wrapped in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Optional"}]," class provided by the Java standard APIs."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Declaring the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"status"}]," field as the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Status"}]," type wrapped in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Optional"}]," class has some benefits to the developer:"]}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":["It helps to avoid possible ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"NullPointerException"}]," errors when accessing a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"null"}]," value."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["It provides a modern way for developers to identify the absence of a value using the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"isPresent()"}]," method from the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Optional"}]," class API and exposes other usable methods like ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"orElse()"}]," and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"orElseThrow()"}],"."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"It clearly states the intent and use of the code, which helps to reduce bugs in the long run."}],"\n"]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Let’s see how client validation works by passing a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"null"}]," value to the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"findPetsByStatus()"}]," method, which expects ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Optional status"}],". We create the following builder pattern for a new request:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"FindPetsByStatusResponse res = sdk.pet().findPetsByStatus(null);\n\nif (res.body().isPresent()) {\n // handle response\n}","lang":"java","meta":"","code":"FindPetsByStatusResponse res = sdk.pet().findPetsByStatus(null);\n\nif (res.body().isPresent()) {\n // handle response\n}","tokens":[["FindPetsByStatusResponse","#66D9EF",{"fontStyle":"italic"}]," ",["res","#F8F8F2"]," ",["=","#F92672"]," ",["sdk.","#F8F8F2"],["pet","#A6E22E"],["().","#F8F8F2"],["findPetsByStatus","#A6E22E"],["(","#F8F8F2"],["null","#AE81FF"],[");","#F8F8F2"],"\n\n",["if","#F92672"]," ",["(res.","#F8F8F2"],["body","#A6E22E"],["().","#F8F8F2"],["isPresent","#A6E22E"],["()) {","#F8F8F2"],"\n ",["// handle response","#88846F"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"When we execute this bit of code, we get the following exception:"}],"\n",["$","$L27",null,{"codeblock":{"value":"java.lang.IllegalArgumentException: status cannot be null\n\tat org.openapis.openapi.utils.Utils.checkNotNull(Utils.java:469)\n\tat org.openapis.openapi.models.operations.FindPetsByStatusRequest$Builder.status(FindPetsByStatusRequest.java:108)\n\tat org.openapis.openapi.Pet.findPetsByStatus(Pet.java:503)","lang":"txt","meta":"","code":"java.lang.IllegalArgumentException: status cannot be null\n\tat org.openapis.openapi.utils.Utils.checkNotNull(Utils.java:469)\n\tat org.openapis.openapi.models.operations.FindPetsByStatusRequest$Builder.status(FindPetsByStatusRequest.java:108)\n\tat org.openapis.openapi.Pet.findPetsByStatus(Pet.java:503)","tokens":[["java.lang.IllegalArgumentException: status cannot be null","#F8F8F2"],"\n\t",["at org.openapis.openapi.utils.Utils.checkNotNull(Utils.java:469)","#F8F8F2"],"\n\t",["at org.openapis.openapi.models.operations.FindPetsByStatusRequest$Builder.status(FindPetsByStatusRequest.java:108)","#F8F8F2"],"\n\t",["at org.openapis.openapi.Pet.findPetsByStatus(Pet.java:503)","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["The same exception is generated if we remove the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"name"}]," field from the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"builder"}]," declaration of a new ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"Pet req = Pet.builder()\n .id(1)\n .photoUrls(java.util.List.of(\n \"https://hips.hearstapps.com/hmg-prod/images/dog-puppy-on-garden-royalty-free-image-1586966191.jpg?crop=1xw:0.74975xh;center,top&resize=1200:*\"))\n .category(Category.builder()\n .id(1)\n .name(\"Dogs\")\n .build())\n .tags(java.util.List.of(\n Tag.builder()\n .build()))\n .build();","lang":"java","meta":"","code":"Pet req = Pet.builder()\n .id(1)\n .photoUrls(java.util.List.of(\n \"https://hips.hearstapps.com/hmg-prod/images/dog-puppy-on-garden-royalty-free-image-1586966191.jpg?crop=1xw:0.74975xh;center,top&resize=1200:*\"))\n .category(Category.builder()\n .id(1)\n .name(\"Dogs\")\n .build())\n .tags(java.util.List.of(\n Tag.builder()\n .build()))\n .build();","tokens":[["Pet","#66D9EF",{"fontStyle":"italic"}]," ",["req","#F8F8F2"]," ",["=","#F92672"]," ",["Pet.","#F8F8F2"],["builder","#A6E22E"],["()","#F8F8F2"],"\n ",[".","#F8F8F2"],["id","#A6E22E"],["(","#F8F8F2"],["1","#AE81FF"],[")","#F8F8F2"],"\n ",[".","#F8F8F2"],["photoUrls","#A6E22E"],["(java.util.List.","#F8F8F2"],["of","#A6E22E"],["(","#F8F8F2"],"\n ",["\"https://hips.hearstapps.com/hmg-prod/images/dog-puppy-on-garden-royalty-free-image-1586966191.jpg?crop=1xw:0.74975xh;center,top&resize=1200:*\"","#E6DB74"],["))","#F8F8F2"],"\n ",[".","#F8F8F2"],["category","#A6E22E"],["(Category.","#F8F8F2"],["builder","#A6E22E"],["()","#F8F8F2"],"\n ",[".","#F8F8F2"],["id","#A6E22E"],["(","#F8F8F2"],["1","#AE81FF"],[")","#F8F8F2"],"\n ",[".","#F8F8F2"],["name","#A6E22E"],["(","#F8F8F2"],["\"Dogs\"","#E6DB74"],[")","#F8F8F2"],"\n ",[".","#F8F8F2"],["build","#A6E22E"],["())","#F8F8F2"],"\n ",[".","#F8F8F2"],["tags","#A6E22E"],["(java.util.List.","#F8F8F2"],["of","#A6E22E"],["(","#F8F8F2"],"\n ",["Tag.","#F8F8F2"],["builder","#A6E22E"],["()","#F8F8F2"],"\n ",[".","#F8F8F2"],["build","#A6E22E"],["()))","#F8F8F2"],"\n ",[".","#F8F8F2"],["build","#A6E22E"],["();","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"When we execute the above code, we get the exception:"}],"\n",["$","$L27",null,{"codeblock":{"value":"java.lang.IllegalArgumentException: name cannot be null\n at org.openapis.openapi.utils.Utils.checkNotNull(Utils.java:469)\n at org.openapis.openapi.models.components.Pet.(Pet.java:62)\n at org.openapis.openapi.models.components.Pet$Builder.build(Pet.java:297)\n at org.openapis.openapi.Test.main(Test.java:40)","lang":"shellscript","meta":"","code":"java.lang.IllegalArgumentException: name cannot be null\n at org.openapis.openapi.utils.Utils.checkNotNull(Utils.java:469)\n at org.openapis.openapi.models.components.Pet.(Pet.java:62)\n at org.openapis.openapi.models.components.Pet$Builder.build(Pet.java:297)\n at org.openapis.openapi.Test.main(Test.java:40)","tokens":[["java.lang.IllegalArgumentException:","#A6E22E"]," ",["name cannot be null","#E6DB74"],"\n ",["at","#A6E22E"]," ",["org.openapis.openapi.utils.Utils.checkNotNull","#E6DB74"],["(","#F8F8F2"],["Utils.java:469","#A6E22E"],[")","#F8F8F2"],"\n ",["at","#A6E22E"]," ",["org.openapis.openapi.models.components.Pet.","#E6DB74"],["<","#F92672"],["ini","#E6DB74"],["t","#F8F8F2"],[">(","#E6DB74"],["Pet.java:62","#A6E22E"],[")","#E6DB74"],"\n ",["at","#A6E22E"]," ",["org.openapis.openapi.models.components.Pet","#E6DB74"],["$$Builder","#F8F8F2"],[".build","#E6DB74"],["(","#F8F8F2"],["Pet.java:297","#A6E22E"],[")","#F8F8F2"],"\n ",["at","#A6E22E"]," ",["org.openapis.openapi.Test.main","#E6DB74"],["(","#F8F8F2"],["Test.java:40","#A6E22E"],[")","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["The null check validation generates this exception when the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object is initiated and certain values are null. If we look at the class constructor in our ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet.java"}]," model in the Speakeasy SDK:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"public Pet(\n @JsonProperty(\"id\") Optional id,\n @JsonProperty(\"name\") String name,\n @JsonProperty(\"category\") Optional category,\n @JsonProperty(\"photoUrls\") java.util.List photoUrls,\n @JsonProperty(\"tags\") Optional> tags,\n @JsonProperty(\"status\") Optional status) {\n Utils.checkNotNull(id, \"id\");\n Utils.checkNotNull(name, \"name\");\n Utils.checkNotNull(category, \"category\");\n Utils.checkNotNull(photoUrls, \"photoUrls\");\n Utils.checkNotNull(tags, \"tags\");\n Utils.checkNotNull(status, \"status\");\n this.id = id;\n this.name = name;\n this.category = category;\n this.photoUrls = photoUrls;\n this.tags = tags;\n this.status = status;\n }","lang":"java","meta":"","code":"public Pet(\n @JsonProperty(\"id\") Optional id,\n @JsonProperty(\"name\") String name,\n @JsonProperty(\"category\") Optional category,\n @JsonProperty(\"photoUrls\") java.util.List photoUrls,\n @JsonProperty(\"tags\") Optional> tags,\n @JsonProperty(\"status\") Optional status) {\n Utils.checkNotNull(id, \"id\");\n Utils.checkNotNull(name, \"name\");\n Utils.checkNotNull(category, \"category\");\n Utils.checkNotNull(photoUrls, \"photoUrls\");\n Utils.checkNotNull(tags, \"tags\");\n Utils.checkNotNull(status, \"status\");\n this.id = id;\n this.name = name;\n this.category = category;\n this.photoUrls = photoUrls;\n this.tags = tags;\n this.status = status;\n }","tokens":[["public","#F92672"]," ",["Pet","#A6E22E"],["(","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"id\"","#E6DB74"],[")","#F8F8F2"]," ",["Optional","#66D9EF",{"fontStyle":"italic"}],["","#F92672"]," ",["id,","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"name\"","#E6DB74"],[")","#F8F8F2"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["name,","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"category\"","#E6DB74"],[")","#F8F8F2"]," ",["Optional","#66D9EF",{"fontStyle":"italic"}],["","#F92672"]," ",["category,","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"photoUrls\"","#E6DB74"],[") java.util.List","#F8F8F2"],["<","#F92672"],["String","#F8F8F2"],[">","#F92672"]," ",["photoUrls,","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"tags\"","#E6DB74"],[")","#F8F8F2"]," ",["Optional","#66D9EF",{"fontStyle":"italic"}],[">","#F92672"]," ",["tags,","#F8F8F2"],"\n ",["@","#F8F8F2"],["JsonProperty","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["\"status\"","#E6DB74"],[")","#F8F8F2"]," ",["Optional","#66D9EF",{"fontStyle":"italic"}],["","#F92672"]," ",["status) {","#F8F8F2"],"\n ",["Utils.","#F8F8F2"],["checkNotNull","#A6E22E"],["(id,","#F8F8F2"]," ",["\"id\"","#E6DB74"],[");","#F8F8F2"],"\n ",["Utils.","#F8F8F2"],["checkNotNull","#A6E22E"],["(name,","#F8F8F2"]," ",["\"name\"","#E6DB74"],[");","#F8F8F2"],"\n ",["Utils.","#F8F8F2"],["checkNotNull","#A6E22E"],["(category,","#F8F8F2"]," ",["\"category\"","#E6DB74"],[");","#F8F8F2"],"\n ",["Utils.","#F8F8F2"],["checkNotNull","#A6E22E"],["(photoUrls,","#F8F8F2"]," ",["\"photoUrls\"","#E6DB74"],[");","#F8F8F2"],"\n ",["Utils.","#F8F8F2"],["checkNotNull","#A6E22E"],["(tags,","#F8F8F2"]," ",["\"tags\"","#E6DB74"],[");","#F8F8F2"],"\n ",["Utils.","#F8F8F2"],["checkNotNull","#A6E22E"],["(status,","#F8F8F2"]," ",["\"status\"","#E6DB74"],[");","#F8F8F2"],"\n ",["this","#FD971F"],[".id","#F8F8F2"]," ",["=","#F92672"]," ",["id;","#F8F8F2"],"\n ",["this","#FD971F"],[".name","#F8F8F2"]," ",["=","#F92672"]," ",["name;","#F8F8F2"],"\n ",["this","#FD971F"],[".category","#F8F8F2"]," ",["=","#F92672"]," ",["category;","#F8F8F2"],"\n ",["this","#FD971F"],[".photoUrls","#F8F8F2"]," ",["=","#F92672"]," ",["photoUrls;","#F8F8F2"],"\n ",["this","#FD971F"],[".tags","#F8F8F2"]," ",["=","#F92672"]," ",["tags;","#F8F8F2"],"\n ",["this","#FD971F"],[".status","#F8F8F2"]," ",["=","#F92672"]," ",["status;","#F8F8F2"],"\n ",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["We can see that the exception is generated in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Utils.checkNotNull()"}]," method:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"public static T checkNotNull(T object, String name) {\n if (object == null) {\n // IAE better than NPE in this use-case (NPE can suggest internal troubles)\n throw new IllegalArgumentException(name + \" cannot be null\");\n }\n return object;\n}","lang":"java","meta":"","code":"public static T checkNotNull(T object, String name) {\n if (object == null) {\n // IAE better than NPE in this use-case (NPE can suggest internal troubles)\n throw new IllegalArgumentException(name + \" cannot be null\");\n }\n return object;\n}","tokens":[["public static <","#F92672"],["T","#F8F8F2"],[">","#F92672"]," ",["T","#66D9EF",{"fontStyle":"italic"}]," ",["checkNotNull","#A6E22E"],["(","#F8F8F2"],["T","#66D9EF",{"fontStyle":"italic"}]," ",["object,","#F8F8F2"]," ",["String","#66D9EF",{"fontStyle":"italic"}]," ",["name) {","#F8F8F2"],"\n ",["if","#F92672"]," ",["(object","#F8F8F2"]," ",["==","#F92672"]," ",["null","#AE81FF"],[") {","#F8F8F2"],"\n ",["// IAE better than NPE in this use-case (NPE can suggest internal troubles)","#88846F"],"\n ",["throw new","#F92672"]," ",["IllegalArgumentException","#A6E22E"],["(name","#F8F8F2"]," ",["+","#F92672"]," ",["\" cannot be null\"","#E6DB74"],[");","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["return","#F92672"]," ",["object;","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Therefore, if we omit the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"name"}]," field or pass a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"null"}]," value in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"findPetByStatus()"}]," method, an exception is generated by the check null validation because the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"name"}]," and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"status"}]," fields explicitly set to ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"null"}]," in this case."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Let’s try creating a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object without a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"name"}]," field using the OpenAPI Generator SDK:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"PetApi apiInstance = new PetApi(defaultClient);\nArrayList snoopyPhotos = new ArrayList<>();\nsnoopyPhotos.add(\"https://Snoopy.some_photo_platform.com\");\n\nPet pet = new Pet(); // Pet | Create a new pet in the store\npet.setPhotoUrls(snoopyPhotos);\ntry {\n Pet result = apiInstance.addPet(pet);\n} catch (ApiException e) {\n //handle exception\n}","lang":"java","meta":"","code":"PetApi apiInstance = new PetApi(defaultClient);\nArrayList snoopyPhotos = new ArrayList<>();\nsnoopyPhotos.add(\"https://Snoopy.some_photo_platform.com\");\n\nPet pet = new Pet(); // Pet | Create a new pet in the store\npet.setPhotoUrls(snoopyPhotos);\ntry {\n Pet result = apiInstance.addPet(pet);\n} catch (ApiException e) {\n //handle exception\n}","tokens":[["PetApi","#66D9EF",{"fontStyle":"italic"}]," ",["apiInstance","#F8F8F2"]," ",["= new","#F92672"]," ",["PetApi","#A6E22E"],["(defaultClient);","#F8F8F2"],"\n",["ArrayList","#66D9EF",{"fontStyle":"italic"}],["<","#F8F8F2"],["String","#66D9EF",{"fontStyle":"italic"}],["> snoopyPhotos","#F8F8F2"]," ",["= new","#F92672"]," ",["ArrayList","#66D9EF",{"fontStyle":"italic"}],["<>();","#F8F8F2"],"\n",["snoopyPhotos.","#F8F8F2"],["add","#A6E22E"],["(","#F8F8F2"],["\"https://Snoopy.some_photo_platform.com\"","#E6DB74"],[");","#F8F8F2"],"\n\n",["Pet","#66D9EF",{"fontStyle":"italic"}]," ",["pet","#F8F8F2"]," ",["= new","#F92672"]," ",["Pet","#A6E22E"],["();","#F8F8F2"]," ",["// Pet | Create a new pet in the store","#88846F"],"\n",["pet.","#F8F8F2"],["setPhotoUrls","#A6E22E"],["(snoopyPhotos);","#F8F8F2"],"\n",["try","#F92672"]," ",["{","#F8F8F2"],"\n ",["Pet","#66D9EF",{"fontStyle":"italic"}]," ",["result","#F8F8F2"]," ",["=","#F92672"]," ",["apiInstance.","#F8F8F2"],["addPet","#A6E22E"],["(pet);","#F8F8F2"],"\n",["}","#F8F8F2"]," ",["catch","#F92672"]," ",["(","#F8F8F2"],["ApiException","#66D9EF",{"fontStyle":"italic"}]," ",["e","#FD971F",{"fontStyle":"italic"}],[") {","#F8F8F2"],"\n ",["//handle exception","#88846F"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"When we execute the above code, we get a mixed result. The following exception is generated:"}],"\n",["$","$L27",null,{"codeblock":{"value":"Exception in thread \"main\" java.lang.IllegalArgumentException: The required field `name` is not found in the JSON string: {\"id\":9223372036854775807,\"photoUrls\":[\"https://Snoopy.some_photo_platform.com\"],\"tags\":[]}\n\tat org.openapitools.client.model.Pet.validateJsonElement(Pet.java:361)\n\tat org.openapitools.client.model.Pet$CustomTypeAdapterFactory$1.read(Pet.java:422)\n\tat org.openapitools.client.model.Pet$CustomTypeAdapterFactory$1.read(Pet.java:412)\n\tat com.google.gson.TypeAdapter$1.read(TypeAdapter.java:204)\n ....","lang":"txt","meta":"","code":"Exception in thread \"main\" java.lang.IllegalArgumentException: The required field `name` is not found in the JSON string: {\"id\":9223372036854775807,\"photoUrls\":[\"https://Snoopy.some_photo_platform.com\"],\"tags\":[]}\n\tat org.openapitools.client.model.Pet.validateJsonElement(Pet.java:361)\n\tat org.openapitools.client.model.Pet$CustomTypeAdapterFactory$1.read(Pet.java:422)\n\tat org.openapitools.client.model.Pet$CustomTypeAdapterFactory$1.read(Pet.java:412)\n\tat com.google.gson.TypeAdapter$1.read(TypeAdapter.java:204)\n ....","tokens":[["Exception in thread \"main\" java.lang.IllegalArgumentException: The required field `name` is not found in the JSON string: {\"id\":9223372036854775807,\"photoUrls\":[\"https://Snoopy.some_photo_platform.com\"],\"tags\":[]}","#F8F8F2"],"\n\t",["at org.openapitools.client.model.Pet.validateJsonElement(Pet.java:361)","#F8F8F2"],"\n\t",["at org.openapitools.client.model.Pet$CustomTypeAdapterFactory$1.read(Pet.java:422)","#F8F8F2"],"\n\t",["at org.openapitools.client.model.Pet$CustomTypeAdapterFactory$1.read(Pet.java:412)","#F8F8F2"],"\n\t",["at com.google.gson.TypeAdapter$1.read(TypeAdapter.java:204)","#F8F8F2"],"\n ",["....","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["It appears that the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Pet"}]," object was created on the API, but the call failed retrospectively on the client side. The exception was generated by the SDK’s validation process, which checks the JSON response received from the API. You can see the created object in the JSON response included in the exception:"]}],"\n",["$","$L27",null,{"codeblock":{"value":"{\"id\":9223372036854775807,\"photoUrls\":[\"https://Snoopy.some_photo_platform.com\"],\"tags\":[]}","lang":"json","meta":"","code":"{\"id\":9223372036854775807,\"photoUrls\":[\"https://Snoopy.some_photo_platform.com\"],\"tags\":[]}","tokens":[["{","#F8F8F2"],["\"id\"","#66D9EF",{"fontStyle":"italic"}],[":","#F8F8F2"],["9223372036854775807","#AE81FF"],[",","#F8F8F2"],["\"photoUrls\"","#66D9EF",{"fontStyle":"italic"}],[":[","#F8F8F2"],["\"https://Snoopy.some_photo_platform.com\"","#CFCFC2"],["],","#F8F8F2"],["\"tags\"","#66D9EF",{"fontStyle":"italic"}],[":[]}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Validation failed because the name was missing from the JSON string. This validation method is not helpful, as it checks the response after the API call rather than before the request is sent. Consequently, an invalid object was created on the API and the client process failed."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Speakeasy’s proactive client validation and method of handling non-nullable fields with the use of the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Optional"}]," class is elegant. Code that is easy to read, understand, and use, and that also helps to build null safety is essential for building robust, maintainable SDKs."]}],"\n",["$","h2",null,{"id":"generated-documentation","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Generated documentation",["$","$L26",null,{"id":"generated-documentation"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Both Speakeasy and OpenAPI Generator generate SDK documentation for the generated code."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Each generator creates a README file to help users get started with the SDK. The OpenAPI Generator README outlines the SDK’s compatibility with Java, Maven, and Gradle versions and identifies the available API routes. The Speakeasy README file is more complete and documents more examples."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["Speakeasy also generates additional documentation in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"docs"}]," directory, including more detailed explanations of the models and operations; examples of creating, updating, and searching objects; error handling; and guidance on handling exceptions specific to the OpenAPI specification file. A handy “Getting Started” section details how to build the SDK."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"In general, we found the Speakeasy documentation to be more complete and helpful. We tested many API call examples from the documentation, and conclude that the Speakeasy docs are production-ready."}],"\n",["$","h2",null,{"id":"supported-java-versions","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Supported Java versions",["$","$L26",null,{"id":"supported-java-versions"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"The Speakeasy-generated SDK supports Java 11+ environments, and the SDK generated by OpenAPI Generator supports Java 8+."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"While the OpenAPI SDK supports more codebases including those still using Java 8, the Speakeasy SDK leverages the enhancements provided by Java 11. Java 8 was released in March 2014, and was the most widely used version of Java until version 11 was released in September 2019."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"In 2023, New Relic reported that Java 11 is used in around 56% of production applications, while Java 8 is still in use at around 33%. Both versions are important long-term support (LTS) versions."}],"\n",["$","h2",null,{"id":"summary","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Summary",["$","$L26",null,{"id":"summary"}]]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"We’ve seen how easy it is to generate a powerful, idiomatic SDK for Java using Speakeasy."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"If you’re building an API that developers rely on and would like to publish full-featured Java SDKs that follow best practices, we highly recommend giving the Speakeasy SDK generator a try."}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":["For more customization options for your SDK using the Speakeasy generator, please see the ",["$","$L25",null,{"href":"/docs/customize-sdks","prefetch":"$undefined","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":"Speakeasy documentation"}],"."]}],"\n",["$","p",null,{"htmlFor":"$undefined","className":"typography-body-md whitespace-normal text-body","children":"Join our Slack community to let us know how we can improve our Java SDK generator or suggest features."}]]]}]]}]]}]}],false]