Policy on Open APIs
Government of India’s Application Programming Interfaces (APIs) Policy
Under the overarching vision of Digital India, the Government of India aims to make all Government services digitally accessible to citizens through multiple channels, such as web, mobile and common service delivery outlets.
The initiatives on 'Open Government' focus on Open APIs to easily access the information collected by Government organizations. Given the enormous advantages in this regard, the Government has come up with a policy for the Government organizations in India to provide Open Application Programming Interfaces (APIs).
At the outset, the 'Policy on Open APIs for Government of India' encourages the formal use of Open APIs in Government organizations. The policy sets out the Government’s approach on usage of 'Open APIs' to promote software interoperability for all e-Governance applications & systems and provide access to data and services for promoting the participation of all stakeholders including citizens.View Government of India’s API Policy
Government of India’s API Policy
- Under the overarching vision of Digital India, Government of India (GoI) aims to make all Government services digitally accessible to citizens through multiple channels, such as web, mobile and common service delivery outlets. To meet this objective, there is a need for an interoperable ecosystem of data, applications and processes which will make the right information available to the right user at the right time.
- In order to make rapid progress in this direction, Government of India (GoI) has taken various policy initiatives, including implementation of Mission Mode Projects (MMPs). Interoperability among various e-Governance systems is an important prerequisite for upgrading the quality and effectiveness of service delivery. It is also required in order to facilitate the single window concept of electronic services delivery by Government organizations.
- For promoting Open Standards for software interoperability across various Government departments and agencies, GoI has already notified the “Policy on Open Standards for e-Governance” and “Technical Standards on Interoperability Framework for e-Governance”. The world-wide initiatives on “Open Government” also focus on open APIs to easily access the information collected by Government organizations.
- Given the enormous advantages in this regard, there is a need to formulate a policy for the Government organizations in India to provide Open Application Programming Interfaces (APIs). The “Policy on Open APIs for Government of India” (hereinafter referred to as the “Policy”) will encourage the formal use of Open APIs in Government organizations. This policy sets out the Government’s approach on the use of “Open APIs” to promote software interoperability for all e-Governance applications & systems and provide access to data & services for promoting participation of all stakeholders including citizens.
- Objectives of the policy:
The objectives of this policy are to:
- Ensure that APIs are published by all Government organisations for all e-Governance applications and systems.
- Enable quick and transparent integration with other e-Governance applications and systems.
- Enable safe and reliable sharing of information and data across various e-Governance applications and systems.
- Promote and expedite innovation through the availability of data from e-Governance applications and systems to the public.
- Provide guidance to Government organizations in developing, publishing and implementation using these Open APIs.
Please refer Appendix – I.
- Policy Statement
Government of India shall adopt Open APIs to enable quick and transparent integration with other e-Governance applications and systems implemented by various Government organizations, thereby providing access to data & services and promoting citizen participation for the benefit of the community. The Open APIs shall have the following characteristics for publishing and consumption:
- The relevant information being provided by all Government organisations through their respective e-Governance applications shall be open and machine readable.
- All the relevant information and data of a Government organisation shall be made available by Open APIs, as per the classification given in the National Data Sharing and Accessibility Policy (NDSAP-2012), so that the public can access information and data.
- All Open APIs built and data provided, shall adhere to National Cyber Security Policy.
- The Government organizations shall make sure that the Open APIs are stable and scalable.
- All the relevant information, data and functionalities within an e-Governance application or system of a Government organisation shall be made available to other e-Governance applications and systems through Open APIs which should be platform and language independent.
- A Government organisation consuming the data and information from other e-Governance applications and systems using Open APIs shall undertake information handling, authentication and authorisation through a process as defined by the API publishing Organisation.
- Each published API of a Government organization shall be provided free of charge whenever possible to other Government organizations and public.
- Each published API shall be properly documented with sample code and sufficient information for developers to make use of the API.
- The life-cycle of the Open API shall be made available by the API publishing Government organisation. The API shall be backward compatible with at least two earlier versions.
- All Open API systems built and data provided shall adhere to GoI security policies and guidelines.
- Government organizations may use an authentication mechanism to enable service interoperability and single sign-on.
- Nature of Compliance
The policy shall be applicable to all Government organisations under the Central Government and those State Governments that choose to adopt this
policy for the following categories of e-Governance systems:
- All new e-Governance applications and systems being considered for implementation.
- New versions of the legacy and existing systems.
- Implementation Mechanism
- GoI shall formulate detailed implementation guidelines for rapid and effective adoption of the policy.
- Government organisations shall publish the APIs so that the public can access relevant information and data from e-Governance applications and systems.
- Government organisations shall publish the APIs for integrating with their e-Governance applications and systems.
- Government organisations shall integrate with the e-Governance applications and systems of other departments through the messaging gateway built on open standards by the Department of Electronics and Information Technology (DeitY).
- Government organisations shall ensure compliance with notified GoI standards for developing APIs.
- GoI shall constitute an Implementation Committee for facilitating the implementation of this policy and its provisions thereof.
- GoI shall establish suitable support mechanism to facilitate API management.
- All Government organizations, while implementing e-Governance applications and systems, must include a specific requirement in the Request for Proposal (RFP) to publish the APIs to public and other Government organizations.
- Review of the Policy
GoI shall have the right to review and revise the policy as and when required.
- Point of Contact
All queries or comments related to the “Policy on Open APIs for Government of India” shall be directed to the Joint Secretary (e-Governance), DeitY at firstname.lastname@example.org.
Appendix – I
- API: The term Application Programming Interface (API) means any mechanism that allows a system or service to access data or functionality provided by another system or service. The API is generally used to interact (like query, list, search, sometimes submit & update) directly with the specific information on a system, to trigger some action on other systems, or to perform some other action on other systems.
- Domain: A sub-category under an Information Technology field is a Domain; specific purpose within a “Domain” is known as “Area”. For example, “Document type for Web publishing content” is one Area under the “Presentation” domain.
- Government organization: For the purpose of this policy, a Government organisation refers to all Ministries/ Departments/ offices/ statutory bodies/ autonomous bodies, both at the Central and State levels. Government organizations offering commercial services are not included.
- e-Governance: A procedural approach in which the Government and the citizens, businesses, and other stakeholders are able to transact all or part of their activities using Information and Communication Technology tools.
- Systems: A group of interacting, interrelated, or interdependent elements forming a complex whole. Information System is a combination of people, hardware, software, communication devices, network and data resources that processes (can be storing, retrieving, transforming information) data and information for a specific purpose.
- Legacy System: An old method, technology, computer system, or application program that continues to be used, typically because it still functions for the users' needs, even though newer technology or more efficient methods of performing a task are now available.
- New version of Legacy System: The legacy system which has undergone a major version change due to re-engineering like functional changes, architectural changes, technology changes, change in storage mechanism, design implementation changes etc.
- Open API: Open API is the API that has been exposed to enable other systems to interact with that system. Open API may be either integrated with the host application or may be an additional piece of software that exposes any proprietary API with an Open API equivalent. The Open API, whenever possible, may be free of charge and without restrictions for reuse & modifications.
- Policy on Open Standards for e-Governance: The Policy on Open Standards for eGovernance provides a framework for the selection of Standards to facilitate interoperability between systems developed by multiple agencies. It is available at https://egovstandards.gov.in/sites/default/files/Policy/Policy%20On%20Open%20Standards/Policy_on_Open_Standards_for_e-Governance_Ver1.0.pdf
- Technical Standards on Interoperability Framework for e-Governance: This document describes technical standards to be adopted for e- Governance application in the areas covered, as per the Policy on Open Standards for e-Governance. Available at https://egovstandards.gov.in/sites/default/files/Published_Standards/Technical%20Standards%20for%20IFEG/Technical_Standards_for_IFEG_Ver1.0.pd f.
- National Data Sharing and Accessibility Policy (NDSAP-2012): The objective of this policy is to facilitate access to Government of India owned shareable data and information in both human readable and machine readable forms through a network all over the country in a proactive and periodically updatable manner, within the framework of various related policies, Acts and rules of Government of India, thereby permitting a wider accessibility and use of public data and information. It is available at http://ogpl.gov.in/NDSAP/NDSAP-30Jan2012.pdf
- National Cyber Security Policy 2013: The objective of this policy is to protect information and information infrastructure in cyberspace, build capabilities to prevent and respond to cyber threats, reduce vulnerabilities and minimize damage from cyber incidents through a combination of institutional structures, people, processes, technology and cooperation. It is available at http://deity.gov.in/content/national-cyber-security-policy-2013-1