[DRAFT] GP Connect (Patient Facing) User Permissions API

This guidance is under active development by NHS Digital and content may be added or updated on a regular basis.

How to use this implementation guide

Intended audience

Intention Audience Description
Clinical Someone who is reviewing the implementation guide from a clinical perspective, including clinical safety, clinical pathway and informatics; as a clinical professional involved in initial implementations or further roll-out approaches
Business Someone who is reviewing the implementation guide from a business process perspective; as a business analyst looking into workflow and the impact on existing business processes
Architect Someone who is reviewing the implementation guide from an architectural perspective; as a solution architect looking into how this implementation will fit in with existing systems and interfaces
Developer Someone who is reviewing the implementation guide from a development perspective, the developer who will be coding or involved in the building of the API or system
Other Someone looking into the contents of the implementation guide for any other reason, for example as part of their education or a research project. This type of audience is implied and not shown in the table below.

Infrastructure guide format and structure

This table shows you the purpose and intended audience of the sections and pages within the guide. The intended audience tells you the type of reader the page is primarily aimed at, but it does not exclude other types of reader from reviewing and feeding back to the team producing the implementation guide.

Note: not all pages described in the table will be present in every implementation guide as the content is dependent on things such as:

  • how the information is exchanged
  • the type of information that is being exchanged
Page Subpage(s) Description and purpose Usage Intended Audience
Home This is the starting point for readers and should be the page that is used when a link is provided to the Implementation Guides Will be present
Introduction This gives a brief overview of the implementation guidance around things such as: uses cases, scope etc. Will be present
How to use this implementation guide This gives a generated site map of the implementation guide and guidance to help them understand the implementation guide Will be present
Release notes Gives the change history and any additional information to help the reader understand the changes to the guide. The latest changes will be added to the top of the page. Will be present
Guide versioning Details versioning of implementation guides and what the different stages are, links to a separate guide Will be present
Glossary A glossary of terms and acronyms used, links to a separate guide Will be present
Design This section details the design of the implementation/ use case, it will detail such things as the interactions, transport used, how the data is exchanged etc. Will be present Clinical,Business,Architect,Developer
Design overview An overview of the design approach Will be present
Interactions This page will contain text and diagrams which describe how the systems/users/device interact with each other Will be present Clinical,Business,Architect,Developer
Transport This page will detail the transport layer used for this implementation guide May be present Business,Architect
Acknowledgments and responses What acknowledgements or responses are used, if any and how and when to use them May be present Clinical,Business,Architect
Events model If a events model is used this page will detail what it is and how its used May be present Clinical,Business,Architect
Events publishing and receiving requirements If this implementation is event based this page will detail publishing and receiving requirements Clinical,Business,Architect
Build This section is about how to build a system or API using this implementation guide Will be present
How to construct bundle This section details how to construct bundles May be present Developers
How to construct message This section details how to construct messages May be present Developers
How to construct message[X] This page may repeat multiple times if there are multiple message types exchanged and will give guidance to developers on how to construct the messages. The [X] will be replaced with the message type or name May be present Developers
API usage This page is used to describe how the API is used in a real life environment May be present Clinical,Business,Architect,Developer
Error handling Describes any error handling that is applicable for the implementation guide May be present Clinical,Business,Architect,Developer
Query types The query types supported by this implementation guide, only applicable for REST May be present Clinical,Business,Architect,Developer
Operation responses This page is used to describe the search operations supported by the API and their responses. May be present Clinical,Business,Architect,Developer
Examples This page gives an overview of the examples section. Will be present Clinical,Business,Architect,Developer
Example [X] A page which contains an example structure. This may be just a single resource or multiple resources. The example may be in JSON or XML or both depending on the format used by the implementation Will be present Clinical,Business,Architect,Developer
Authentication This page needs a brief overview of the authentication section May be present Architect,Developer
Access control This page describes the access control guidance or requirements May be present Architect,Developer
Access tokens This page describes the access tokens guidance / requirements May be present Architect,Developer
Auditing This page describes the auditing requirements May be present Architect,Developer
Security This page describes the security guidance / requirements May be present Architect,Developer
Integration with SPINE This page describes any guidance / requirements about integration with SPINE. May be present Architect,Developer
Downloads This page provides link(s) to download artefacts that may be useful to help with developments such as NPM packages for validation Will be present Clinical,Business,Architect,Developer
Help and support This page gives contact details for help and support Will be present Clinical,Business,Architect,Developer

Sitemap

back to top