Skip to content

Restrict stream_id Character Set for URL Parameter Compatibility #229

Open
@thomasdarimont

Description

The current specification draft for the Shared Signals Framework defines stream_id as follows:

stream_id

Transmitter-Supplied, REQUIRED. A string that uniquely identifies the stream. A Transmitter MUST generate a unique ID for each of its non-deleted streams at the time of stream creation.

Since stream_id is intended to be used as a URL parameter, it is important to ensure that the character set is restricted to those that are safe for use in URLs. Without such a restriction, there is potential for issues with URL encoding/decoding or interoperability across systems.

Proposed Change

Add the following normative language to the specification:

The stream_id value MUST be limited to characters that are safe for use in URL parameters as defined in RFC3986.
Specifically, stream_id MUST conform to the "unreserved" character set defined in Section 2.3 of RFC 3986, which includes alphanumeric
characters (A-Z, a-z, 0-9), hyphen (-), period (.), underscore (_), and tilde (~).
A Transmitter MUST validate that all stream_id values conform to this character set.

This addition ensures that stream_id is URL-safe and can be used reliably as a URL parameter without requiring additional encoding or risk of invalid characters.

Metadata

Assignees

No one assigned

    Labels

    v1FinalIssues that must be fixed before we propose a spec to become a v1 final spec.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions