CDN uploads

Bridge 1.2.1 supports the provider names fivemanage and qbox. Each resource selects a provider when it calls the bridge's server exports.

Set an API keyCopy Anchor Link

Create an API key in FiveManage or the Qbox dashboard. Set the key's permissions and folder access for the file types your resource uploads.

Add the matching key before the bridge's ensure line. Use set so the key stays server-only.

set 402studio_bridge:fivemanageKey "YOUR_FIVEMANAGE_KEY"
set 402studio_bridge:qboxKey "YOUR_QBOX_CDN_KEY"

ensure 402studio_bridge

Keep API keys in your private server configuration. The bridge uses the key in a server HTTP request and returns a temporary upload URL to the calling resource.

Request an upload URLCopy Anchor Link

Call CreateCdnUpload from a server thread or handler that can yield:

local target, errorCode = exports['402studio_bridge']:CreateCdnUpload('qbox')
if not target then
    print(('Upload setup failed: %s'):format(errorCode))
    return
end

Pass target.url and target.formField to your resource's multipart uploader. The temporary URL authorizes that upload. Upload promptly and request a fresh URL when it expires.

Presigned requests time out after 10 seconds. FiveManage upload URLs expire five minutes after the bridge requests them.

Resolve a completed uploadCopy Anchor Link

When your server upload callback completes, pass its result to ResolveCdnUpload using the same provider:

local file, errorCode = exports['402studio_bridge']:ResolveCdnUpload('qbox', result)
if not file then
    print(('Upload result rejected: %s'):format(errorCode))
    return
end

The result table contains status = 'success' and the provider's JSON response in response. The provider response contains status = 'ok' and data.url. The bridge accepts that response as a Lua table or JSON string.

The returned file.url is the hosted HTTPS file URL. file.id contains the provider's file ID when supplied. Save the URL with your resource's own record and player identifier when building a media library. File availability follows the provider's storage and retention settings.

Server exportsCopy Anchor Link

IsCdnAvailable checks the adapter registration. CreateCdnUpload checks the configured key and contacts the provider. All three exports use the bridge's resource access rules.

Upload errorsCopy Anchor Link