Page Comparison

PR #87: Update Device object handling and description

• Other APIs passing a Device object do this by passing a separate parameter named device, even if that is the only object passed in the request.

• This PR:

  • Updates the Device Identifier API to use this pattern
  • Updates documentation on identifying the device from the access token following the current agreement in Commonalities
  • Updates the API error responses following the current agreement in Commonalities
  • Removes 406, and 5XX errors from the OAS definition, as these errors do not need to be explicitly documented and are not relevant to the API use case

MEETING UPDATES

06 Dec 2024:

• Add examples for different request body scenarios
• Leave open for comments until next meeting

03 Jan 2025:

• Updates since last meeting
  • Request body scenario examples added
  • 406 and 5XX errors removed
  • Remaining error examples updated
• PR to remain open for comments until 17 Jan 2025 

PR #89: Remove multi-sim text

• Multi-SIM support is not well-understood and should be "solved" for all CAMARA APIs.

• Multi-SIM support was discussed in several CAMARA API subprojects without solution.

• For interoperability reasons API providers should handle the Multi-SIM case in the same manner.

MEETING UPDATES

03 Jan 2025:

• Eric Murray to propose more generic text describing different options for multi-SIM scenario handling

PR #90: Use identifier instead of identity

• Use the term "identifier" if an identifier is talked about.

• Operators often use the term "identity" when in fact it is an "identifier". Generally an "identity" and an "identifier" are different. There a several definitions for "identity" e.g. in OIDF, IETF and W3C e.g. "a collection of claims". But identity is never used when an identifier is meant.

• I think we should avoid operator-speak and use "identifier" if it is an "identifier".

MEETING UPDATES

03 Jan 2025:

• IMEI definition reverted to International Mobile Equipment Identity
• PR approved and merged

PR #91: Update error response schema following Commonalities update

• Update error response schema to comply with Commonalities CAMARA_common.yaml

MEETING UPDATES

03 Jan 2025:

• Wait for PR #87 to be merged and then fix any conflicts with this one.
• Goal is to approve and merged the updated PR before next meeting

PR #92: Use scopes and introduce a pairwise pseudonymous identifier

• This PR proposes two changes to the API definition:

  • Introduction of a third device identifier ppid, which is a pairwise pseudonymous identifier for the device
  • Control of fields included in the response by individual scopes, rather than by a single scope covering all possible response fields

MEETING UPDATES

03 Jan 2025:

• Discussion:
  • PPID as third device identifier is fine, but should be introduced as additional endpoint rather than controlling through scopes
  • A better description of the properties of a PPID is required, in addition to the external link
    • For example, if a new SIM (from the same MNO) is used in the physical device, should the PPID be re-generated?
• Eric Murray to comment in PR

Issue #80: Purpose of the lastChecked field in the response?

• lastChecked response field is not clear to all potential API consumers
• This is the last time that the API provider checked which IMEI was being used by a specific MSISDN
  • Could be "now", or could be some minutes ago. Implementation dependent.
• How to fix?
  • Rename field (maybe to lastConfirmed)?
  • Better description in YAML itself?

MEETING UPDATES

04 Oct 2024 :

• Leave issue open for now. Axel Nennker to review how this would be supported by DT.

01 Nov 2024:

• Eric Murray to propose updated description for this field

06 Dec 2024

• To be fixed by PR#88: Update LastChecked description

03 Jan 2025

• Will be closed by PR#88

• Issue #21: API Definition Terminology

  • Issue is out of date

MEETING UPDATES

06 Dec 202403 Jan 2025:

• • Still open

ACTIONS:

• • Eric Murray to update issue text (still open)