![\"\"](\"https:\/\/www.backblaze.com\/blog\/wp-content\/uploads\/2021\/10\/13ead90ec7c7b8f31b6faecb85dd9c40.jpg\")
<\/p>\n<\/p>\n
Backblaze B2 Cloud Storage enables thousands of developers\u2014from video streaming applications like Kanopy<\/a> to gaming platforms like Nodecraft<\/a>\u2014to easily store and use data in the cloud. Those files are always available for download either through a browser-compatible URL or APIs.<\/p>\n Backblaze supports two different suites of APIs\u2014the Backblaze B2 Native API and the Backblaze S3 Compatible API. Sometimes, folks come to our platform knowing exactly which API they need to use, but the differences between the two are not always immediately apparent. If you\u2019re not sure which API is best for you and your project, we\u2019re explaining the difference today.<\/p>\n In July 2023, Backblaze announced<\/a> our new Technical Documentation Portal, designed to make the technical how-tos of Backblaze easy to use, easy to understand, and easy to share. If you’re looking for Quick-Start Guides<\/a>, SDKs<\/a>, integrations<\/a>, API documentation<\/a>, or other technical support, head on over to the portal<\/a> for more. If you want to learn more about Backblaze’s APIs in general, read on.<\/p>\n<\/div>\n Put simply, an application programming interface, or API, is a set of protocols that lets one application or service talk to another. They typically include a list of operations or calls developers can use to interact with said application (inputs) and a description of what happens when those calls are used (outputs). Both the B2 Native and S3 Compatible APIs handle the same basic functions:<\/p>\n The main difference between the two APIs is that they use different syntax for the various calls. We\u2019ll dig into other key differences in more detail below.<\/p>\n The B2 Native API is Backblaze\u2019s custom API that enables you to interact with Backblaze B2 Cloud Storage. We\u2019ve written in detail about why we developed our own custom API<\/a> instead of just implementing an S3-compatible interface from the beginning. In a nutshell, we developed it so our customers could easily interact with our cloud while enabling Backblaze to offer cloud storage at a quarter of the price of S3<\/a>.<\/p>\n To get started, simply create a Backblaze account and enable Backblaze B2. You\u2019ll then get access to your Application Key and Application Key ID. These let you call the B2 Native API.<\/p>\n Over the years since we launched Backblaze B2 and the B2 Native API, S3 compatibility was one of our most requested features. When S3 launched in 2006, it solved a persistent problem for developers\u2014provisioning and maintaining storage hardware. Prior to S3, developers had to estimate how much storage hardware they would need for their applications very accurately or risk crashes from having too little or, on the flip side, paying too much as a result of over-provisioning storage for their needs. S3 gave them unlimited, scalable storage that eliminated the need to provision and buy hardware. For developers, the service was a game-changer, and in the years that followed, the S3 API essentially became industry standard for object storage.<\/p>\n In those years as well, other brands (That\u2019s us!) entered the market. AWS was no longer the only game in town. Many customers wanted to move from Amazon S3 to Backblaze B2, but didn\u2019t want to rewrite code that already worked with the S3 API.<\/p>\n The Backblaze S3 Compatible API does the same thing as the B2 Native API\u2014it allows you to interact with B2 Cloud Storage\u2014but it follows the S3 syntax. With the S3 Compatible API, if your application is already written to use the S3 API, B2 Cloud Storage will just work, with minimal code changes on your end. The launch of the S3 Compatible API provides developers with a number of benefits:<\/p>\n To get started, create a Backblaze account and head to the App Keys page. The Master Application Key will not be S3 compatible, so you\u2019ll want to create a new key and key ID by clicking the \u201cAdd a New Application Key\u201d button. Your new key and key ID will work with both the B2 Native API and S3 Compatible API. Just plug this information into your application to connect it to Backblaze B2.<\/p>\n If your existing tools are written to the S3 API\u2014for example, tools like Cohesity, rclone<\/a>, and Veeam<\/a>\u2014they\u2019ll work automatically once you enter this information. Additionally, many tools\u2014like Arq, Synology, and MSP360\u2014were already integrated with Backblaze B2 via the B2 Native API, but now customers can choose to connect with them via either API suite.<\/p>\n Beyond the syntax, there are a few key differences between the B2 Native and Backblaze S3 Compatible APIs, including:<\/p>\n Key management is unique to the B2 Native API. The S3 Compatible API does not support key management. With key management, you can create, delete, and list keys using the following calls:<\/p>\n Some of our Alliance Partners asked us if we had an SDK they could use. To answer that request, we developed an official Java SDK<\/a> and Python SDK<\/a> on GitHub so you can manage and configure your cloud resources via the B2 Native API.<\/p>\n Meanwhile, long-standing, open-sourced SDKs for S3 Compatible APIs are available in any language including Go<\/a>, PHP<\/a>, Javascript<\/a>, Ruby<\/a>, etc. These SDKs make it easy to integrate your application no matter what language it\u2019s written in.<\/p>\n What Is an SDK?<\/strong>SDK stands for software development kit. It is a set of software development tools, documentation, libraries, code snippets, and guides that come in one package developers can install. Developers use SDKs to build applications for the specific platform, programming language, or system the SDK serves.<\/p>\n<\/div>\n By default, access to private buckets is restricted to the account owner. If you want to grant access to a specific object in that bucket to anyone else\u2014for example, a user or a different application or service\u2014they need proper authorization. The S3 Compatible API and the B2 Native API handle access to private buckets differently.<\/p>\n The S3 Compatible API handles authorization using pre-signed URLs. It requires the user to calculate a signature (code that says you are who you say you are) before sending the request. Using the URL, a user can either The S3 Compatible API supports pre-signed URLs for downloading and uploading. Pre-signed URLs are built into AWS SDKs. They can also be generated in a number of other ways including the AWS CLI and AWS Tools for PowerShell. You can find guides for configuring those tools here<\/a>. Many integrations, for example, Cyberduck, also offer a simple share functionality that makes providing temporary access possible utilizing the underlying pre-signed URL.<\/p>\n The B2 Native API figures out the signature for you. Instead of a pre-signed URL, the B2 Native API requires an authorization token to be part of the API request itself. The With the S3 Compatible API, you upload files to a static URL that never changes. Our servers automatically pick the best route for you that delivers the best possible performance on our backend.<\/p>\n The B2 Native API requires a separate call to get an upload URL. This URL can be used until it goes stale (i.e. returns a 50X error)<\/a>, at which point another upload URL must be requested. In the event of a 50X error, you simply need to retry the request with the new URL. The S3 Compatible API does this for you in the background on our servers, which makes the experience of using the S3 Compatible API smoother.<\/p>\n This difference in the upload process is what enabled Backblaze B2 to offer substantially lower prices at the expense of a little bit more complexity. You can read more about that here<\/a>.<\/p>\n So, which API should you use? In a nutshell, if your app is already written to work with S3, if you’re using tools that are written to S3, or if you’re just unsure, the S3 Compatible API is a good choice. If you’re looking for more control over access and key management, the B2 Native API is the way to go. Either way, now that you understand the differences between the two APIs you can use to work with B2 Cloud Storage, you can align your use cases to the functionality that best suits them and get started with the API that works best for you.<\/p>\n If you\u2019re ready to try out the B2 Native or S3 Compatible APIs for yourself, check out our documentation:<\/p>\n Of course, if you have any questions, fire away in the comments or reach out to our Sales team<\/a>. And if you\u2019re interested in trying Backblaze, get started today<\/a> and your first 10GB of storage are free.<\/p>\n","protected":false},"excerpt":{"rendered":" If you’re just getting started with B2 Cloud Storage, this post will explain the differences between the Backblaze S3 Compatible API and the B2 Native API, and which is best for your use case.<\/p>\n","protected":false},"author":159,"featured_media":103157,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","footnotes":""},"categories":[7],"tags":[468],"class_list":["post-103127","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cloud-storage","tag-b2cloud","entry"],"acf":[],"yoast_head":"\n\nEditor’s Note: Technical Documentation Portal<\/h4>\n
B2 Native API vs. S3 Compatible API: What\u2019s the Diff?<\/strong><\/h2>\n
\n
The Backblaze B2 Native API<\/strong><\/h3>\n
The Backblaze S3 Compatible API<\/strong><\/h3>\n
\n
![\"\"](\"https:\/\/www.backblaze.com\/blog\/wp-content\/uploads\/2021\/10\/image2-1024x997.png\")
B2 Native and S3 Compatible APIs: How Do They Compare?<\/strong><\/h2>\n
\n
Key Management<\/strong><\/h3>\n
\n
b2_create_key<\/code><\/li>\nb2_delete_key<\/code><\/li>\nb2_list_keys<\/code><\/li>\n<\/ul>\nSDKs<\/strong><\/h3>\n
\nPre-signed URLs<\/strong><\/h3>\n
read<\/code> an object, write<\/code> an object, or update an existing object. The URL also contains specific parameters like limitations or expiration dates to manage their usage.<\/p>\nb2_authorize_account<\/code> request gets the authorization token that you can then use for account-level operations. If you only want to authorize downloads instead of all account-level operations, you can use the request b2_get_download_authorization<\/code> to generate an authorization token, which can then be used in the URL to authenticate the request.<\/p>\nUploading Files<\/strong><\/h3>\n
Try It Out for Yourself<\/strong><\/h2>\n
\n