Australian Government Architecture
Search

Application programming interfaces (APIs)

Definition

An application programming interface (API) is a set of rules, protocols, and tools that allows different software applications to communicate with each other. It acts as an intermediary layer that allows the transfer of data between different systems, services, and libraries. 

APIs will generally fall into one of the following categories:

  • system level APIs: low-level APIs that are exposed directly by an application.
  • process level APIs: APIs composed of other System APIs through orchestration and choreography.
  • experience Level APIs: APIs intended to ease the adoption of API integration between an organisation and its external consumers.

APIs may also be grouped as:

  • private APIs, being utilised to facilitate internal system-to-system connection
  • partner APIs, being used to connect entity business partners to the relevant systems needed for government service provision
  • public APIs, being used to connect external parties to government systems and data.

Purpose

APIs enable entities to open their application data and functionality to internal branches, business partners, third-party developers, and other key internal and external stakeholders, allowing for seamless collaboration and information sharing.

API capability is realised through:

  • deployment and use of system-specific APIs provided by technology platform suppliers to allow direct system interface and system-to-system interoperability
  • use of API gateways, both proprietary and open source, that allow the connection of single or multiple APIs in addition to providing routing, monitoring, and security and access control functions
  • development and release of system-specific APIs by platform owners, typically Commonwealth entities responsible for platform development and maintenance
  • supply of APIs at the discretion of the developing entity, dependent on the interoperability context (e.g. internal, intra-entity, internal).

Objective

The objectives of this content are to:

  • enable interoperability between Commonwealth entities
  • facilitate sharing of non-sensitive data, where suitable and in accordance with Information Asset Management guidelines, to individuals and organisations who might use it to the benefit of the Commonwealth
  • consolidate and standardise API solutions with aligned functions to increase efficiency and reduce the complexity of government service delivery
  • establish and implement consistent standards or designs where entity solutions require API use
  • ensure that new solutions that require the use of APIs draw efficiency from preceding investments, implementations, and learnings
  • recognise and protect the Commonwealth’s investment in the development of APIs as a valuable ICT asset
  • promote decoupling of business systems and processes to ensure agility when upgrading or modifying an entity’s ICT environment
  • encourage adoption, where suitable, of low-code to no-code solutions that allow the development of APIs through a human centred interface rather than programmatically
  • maximise the potential for reuse across government when implementing new systems that need APIs
  • reduce implementation risk through the reuse of proven designs within government
  • leverage whole-of-government purchasing arrangements for the supply of technology supplier-specific APIs.

Whole-of-government applicability

The Data and Digital Government Strategy (DDGS) sets a vision for 2030 to deliver simple, secure and connected public services for all people and business, through world class data and digital capabilities.

API capability will be key to the DDGS missions of ‘Simple and seamless services’ and ‘Delivering for all people and business’. APIs solutions are employed by Commonwealth entities of all sizes, allowing data exchange between entities and with other organisations/individuals, supporting progress against the mission objectives to:

  • ‘maximise value from data’ - requiring all Commonwealth entities to make non-sensitive data open by default in compliance with relevant laws and appropriate privacy, security and ethical controls for sharing sensitive data
  • 'deploy scalable and secure architecture' - adopting existing and developing new data and digital standards to improve interoperability and encourage innovation
  • 'tell us once' - strengthening use of data and digital technologies and capabilities to enable a ‘tell us once’ approach.

Domains

This capability is part of the following domain.
DOM8

Integration and interoperability

Policies

The following policies have requirements that impact this capability.
Mandate: Endorsed
Status: Core
This policy outlines requirements for Commonwealth entities to ensure that reuse opportunities are identified, and that API solutions are sustainable and meet best practices. Applicability Digital investment proposals are assessed against this policy by the DTA through the Digital and ICT…

Standards

The following standards support development of digital solutions in this capability.
API solutions can facilitate the interconnection of Commonwealth entity, supplier, and partner functionality needed by government to manage internal and external engagements with stakeholders. Internal interoperability via API functionality can increase productivity, efficiency, accuracy, and…

Designs

The following designs include examples of how digital solutions in this capability can be delivered.

Lead Agency: Digital Transformation Agency

api.gov.au has been designed to give technology developers, researchers, and other parties access to a range of APIs (Application Programming Interfaces) that can be used to integrate systems access to a range of functions from across government. It includes Australian Government - API Design…

Lead Agency: Australian Bureau of Statistics

Technology Type: .Stat Suite, API, SDMX

The ABS Data API (Beta) allows users to request detailed ABS statistics including economic, social and Census data. Data is published after embargo is lifted at 11:30am and is usually available by 12:30pm (Canberra time) on release day. The API provides detailed access to a wide range of ABS…

Lead Agency: Australian Bureau of Statistics

Technology Type: .Stat Suite, Amazon Web Services, API, SDMX

The Australian Bureau of Statistics (ABS) offers a number of data services that allow users to access ABS data and metadata. Some of these services are available through the Application Programming Interfaces (APIs), that enable machine to machine contact and exchange of data.

Lead Agency: Comcare

Technology Type: Microsoft Dynamics 365

Integrated Regulatory Information System (IRIS) is the primary application used by Comcare’s Regulatory Operations Group for various regulatory licensing, monitoring, compliance, and investigation tasks. It is a central, organised, easy-to access place to store data about notifications (work health…
Was this information helpful?

Do not include any personal information. We are unable to respond to comments or feedback. If you would like a response, please email, or phone us. Our details are on the AGA contact page www.architecture.digital.gov.au/contact-us.