Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

CIECA

CIECA API Standards (CAPIS)

BUSINESS PLAN

👥 Interested Party and Level of Commitment, Pioneer Companies

Member/Companies Include:

  • Dan Webster, Mitchell

  • Phil Martinez, Mitchell

  • Jeff Schroeder, Car-Part.com

  • Andy Bober, Entegral

  • Mike Hastings, Car-Part.com

Note:  Membership is open to any company who is a member of ARA or CIECA.
Note:  Sublet items, where parts are considered as sublet, will be addressed at a later date (i.e., services, auto glass, etc.).
Note:   Use of the CIECA standard requires the user to be a CIECA member.  Membership is not required for the purchase and use of products that contain the CIECA products.

📜 History

CIECA has been working to provide an API solution for many years. In the 2020R1 Release, CIECA provided members with experimental JSON messages schemas that were build over built using the current XML schemas. This did provide JSON messagesschemas, however, it reproduced the complexity and the size of the XML messages.

The industry expects API solutions to be flexible, simple and small. To meet the industry expectations, CIECA’s Architecture Committee introduced an API project to build new API standards with the open API framework in mind and not duplicating the current XML complexity.

🏆 Objective

To create new API standards that CIECA members can easily implement with other partners in the industry.

☑ Benefits to Industry Segment

The following is a list of possible industry benefits:

  1. Support CIECA members to

use Open API solution.
  • An accurate and efficient process for handling data for different Business Use Cases, which will prevent maintenance of numerous solutions to handle one Use Case.

    1. modernize application programming interface(s).

    2. Improved accuracy and efficiency

    through an understanding and use of industry standards.
  • Simplification of implementing standards. Fresh start to JSON that is not built over the existing JSON and XML messages.

  • Reduced latency of exchanging messages.

  • New JSON messages will support modern tools and specifications.

  • Greater segmentation of messages to enhance data privacy.

    Benefit is to have option to use
    1. .

    2. Leverage the security allowed in the open API framework.

    The Current BMS XML is large and complicated, the JSON messages will be smaller and simpler
    1. Simplified and Targeted schemas that segment data to match specific workflows.

    🎯 Deliverables

    CAPIS - CIECA API Standards

    • Guidelines for API/JSON messages for other committees to follow

      • formalized http verbs

      • use standardized data types in JavaScript

      • flexible implementation of Use Cases

      • what drives non standards messages and a way to provide solution

    • CAPIS(CIECA API Standards) Documentation

      • Use Cases - An IG Appendix C to provide business use cases for system developers

      • Flow Charts

      • An Implementation Guide (IG) to define the business information

    • Data Standards

    • JSON MessagesOpen API Spec

      • Schema

      • Test Instances

      • SchemaData Types

      • Code Examples

    💼 Resource Requirements

    Staff  

    Staff times for project support are included with CIECA membership for approved projects.  Staff time will include project management assistance as well as technical assistance.

    Volunteer Time:

    Business volunteers will be needed to identify business requirements of the message contents.  Representation from multiple areas of the business segment will make the message development more complete and better serve the entire industry.  Business volunteers will also be needed for the development of the Implementation Guides.

     

    Technical volunteers will be needed to complete the translation of business needs to the BMS representation of those business needs and work with Architecture in this integration.  Assistance will be made available from members of Architecture.

    🗓 Releases

    Release Name

    Value it adds

    Scope

    Status

    Completed date

    Status
    titleTo do
    /
    Status
    colourBlue
    titleIn progress
    /
    Status
    colourRed
    titleBlocked
    /
    Status
    colourYellow
    titleWaiting for feedback
    /
    Status
    colourGreen
    titleDone

    🐾 Next steps

    •   StatustitleSet a status

    📈 Impact

    🔗 Other Documents