Information
- License: Apache-2.0
- OpenAPI version:
3.1.0
Overview
The Share2Us v1 API and public download gateway.
Share2Us API 0.1.0
Section titled “Share2Us API 0.1.0”Share2Us moves a file between people, devices and agents through one opaque, expiring link. This contract covers the authenticated v1 API and the public gateway that serves a link to whoever opens it.
It is the source of truth for the wire format: handlers are checked against it, and a change lands here before it ships. The API is in private beta, so endpoints can still change; anything that would break a client is called out in the release notes for the clients that use it.
Content encrypted end to end is opaque to this API. The server stores and serves ciphertext and never holds the key, so no endpoint here can return the plaintext of an encrypted share.
Authentication
Section titled “Authentication”bearerAuth
Section titled “bearerAuth”Security scheme type: http
Bearer format: Firebase ID token
deviceAuth
Section titled “deviceAuth”Security scheme type: apiKey
Header parameter name: X-Share2Us-Device-Token
apiTokenAuth
Section titled “apiTokenAuth”Security scheme type: http
Bearer format: Share2Us API token
sessionManageTokenAuth
Section titled “sessionManageTokenAuth”Security scheme type: apiKey
Header parameter name: X-Session-Manage-Token