Page Comparison

DRAFT

Attendees & Representation

...

Error Alignment
- https://github.com/camaraproject/Commonalities/issues/321#issuecomment-2429158445 - remove explicit definitions from CAMARA API OAS - as common error semantics is applied:
  - 4xx:
    - 405 METHOD_NOT_ALLOWED: In OAS only the supported methods are documented, so any other method not explicitly indicated will get 405, but we do not need to include those not supported methods in the spec with a 405 response.
    - 406 NOT_ACCEPTABLE: OAS defines what it is accepted
    - 415 UNSUPPORTED_MEDIA_TYPE: OAS defines the accepted content types
  - 5xx
    - 500 - INTERNAL - Unknown server error. Typically a server bug.
    - 503 - UNAVAILABLE - Service Unavailable.
    - 504 - TIMEOUT - Request timeout exceeded.
- Device or phone number related error codes unification
  - UNSUPPORTED_API_SUBJECT_IDENTIFIER -> UNSUPPORTED_IDENTIFIER
  - API_SUBJECT_NOT_FOUND -> IDENTIFIER_NOT_FOUND
  - SERVICE_NOT_APPLICABLE_TO_API_SUBJECT -> SERVICE_NOT_APPLICABLE
  - API_SUBJECT_CANNOT_BE_IDENTIFIED -> MISSING_IDENTIFIER
  - UNNECESSARY_API_SUBJECT_IDENTIFIER -> UNNECESSARY_IDENTIFIER
  - API_SUBJECT_IDENTIFIER_MISMATCH -> IDENTIFIER_MISMATCH
https://github.com/camaraproject/Commonalities/issues/318
- The correct target is https://lf-camaraproject.atlassian.net/wiki/x/3yLe
https://github.com/camaraproject/Commonalities/issues/319
- Proposal in https://github.com/camaraproject/Commonalities/pull/320
  - Please review and propose additional content - can be finalized together with new API Design Guidelines document PR#317
https://github.com/camaraproject/Commonalities/issues/323
- Proposal in https://github.com/camaraproject/Commonalities/pull/325
  - Please review the proposed test scenarios
https://github.com/camaraproject/Commonalities/issues/326
- Agreed to be resolved within PR #313
https://github.com/camaraproject/Commonalities/issues/327