clarify the session ID API properties

This documents the properties of the session ID APIs and includes them in the test suite.

Checklist

• Test suite updated with functionality tests
• Documentation updated

Reviewer's checklist:

• Any issues marked for closing are addressed
• There is a test suite reasonably covering new functionality or modifications
• Function naming, parameters, return values, types, etc., are consistent and according to CONTRIBUTION.md
• This feature/change has adequate documentation added
• No obvious mistakes in the code