SlideShare a Scribd company logo
Requester Specification
Version 1.0
September 2015
A Digital India Initiative
National e-Governance Division.
Department of Electronics and Information Technology.
Requester Specification
1
Revision History
Version Date Author Comments
1.0 12/08/2015 Amit Savant (NeGD) Version 1.0 Released.
Requester Specification
2
Table of Contents
Revision History.......................................................................................................................................................1
Introduction...............................................................................................................................................................3
Requester Workflow..............................................................................................................................................3
Step 1: User clicks “Choose from DigiLocker” button on the client application........................3
Step 2: DigiLocker Requestor Widget pops up and prompts user to login. ................................4
Step 3: User logs in to the account and selects a file to share...........................................................4
Step 4: DigiLocker shares file with the client application and shows status message............5
Steps to Integrate Requester Workflow.........................................................................................................5
Step 1: Register as Requestor on DigiLocker...........................................................................................5
Step 2: Register Requestor Application and Domain on DigiLocker..............................................6
Step 3: Integrate DigiLocker Requestor Widget in your web application ...................................6
Integrating with Digital Locker..........................................................................................................................6
REQUESTER REGISTRATION ....................................................................................................................6
TRIGGERING DIGILOCKER FROM YOUR WEB PAGE.......................................................................7
HANDLING THE RESPONSE.......................................................................................................................8
Requester Specification
3
Digital Locker Requester Specification
Introduction
This document provides detailed specification to integrate with Digital Locker as a
Requester. The steps described in this document will be used by various departments to
access users’ documents from their Digital Locker. This document assumes that the reader
is aware of the Digital Locker application functionality.
Requester Workflow
Step 1: User clicks “Choose from DigiLocker” button on the client
application.
Requester Specification
4
Step 2: DigiLocker Requestor Widget pops up and prompts user to login.
Step 3: User logs in to the account and selects a file to share.
Requester Specification
5
Step 4: DigiLocker shares file with the client application and shows status
message.
Steps to Integrate Requester Workflow
Step 1: Register as Requestor on DigiLocker
Requester Specification
6
Step 2: Register Requestor Application and Domain on DigiLocker
Step 3: Integrate DigiLocker Requestor Widget in your web application
Integrating with Digital Locker
REQUESTER REGISTRATION
The first step in integrating with Digital Locker application is to register on Digital Locker as
a Requester. On the successful registration, the Requester application must be registered
Requester Specification
7
along with the domain of your application from which the requests to Digital Locker will be
initiated. During the registration process you create an application id (app id) for your
application. You are provided with an api key which is a secret key. The App Id and the api
key are used to authenticate the request from your application.
TRIGGERING DIGILOCKER FROM YOUR WEB PAGE
DigiLocker provides a Requestor Widget to share files from DigiLocker. This widget can be
launched with a button provided by DigiLocker Javascript library. The launches DigiLocker
application login page in a popup. A user can login to his/her DigiLocker account to select a
file that the user want to share with the requestor application. This button looks like this -
Once you register as a Requester and register your application with Digital Locker, add
following JavaScript snippet to your web page.
<script src="jquery.min.js"></script>
<script type="text/javascript"
src="https://services.digitallocker.gov.in/requester/api/1/dl.js"
id="dlshare" data-app-id="YOUR_APP_ID" data-app-hash="YOUR_APP_HASH"
time-stamp=”TIMESTAMP” data-upload-url="YOUR_UPLOAD_URL">
</script>
Please note that the DigiLocker library uses jQuery. So please download jquery.min.js file
from jQuery.com and place it on your web server. Specify the path of this file in the above
snippet in the src parameter of jQuery script.
Provide app id that was provided during the application registration process in data-app-
id parameter.
Provide SHA-256 encrypted value of your app id, app key and the timestamp values in this
sequence in data-app-hash parameter.
Provide the url of the service that uploads the file from the public url of the document
provided by Digital Locker in data-upload-url parameter. Please referto Handling The
Response section below for more details.
Provide a timestamp value in IST time zone in time-stamp parameter. This timestamp
value must not be older than 30 minutes.
To add the “Choose from DigiLocker” button to your page, add following line to your web
page where you want to add the button. Provide a unique id for every instance of the
button on your web page. The value of id can be used to identify the type of document
being shared by a user.
Requester Specification
8
<div class="share_fm_dl" id="attachment_poi"></div>
If the integration is successful, the DigiLocker Requestor Widget will be launched and you
will see the DigiLocker login page. If there is an error in the integration, the widget will
show an authentication error and an error code. Following table lists the error codes.
Code Description
203 Invalid app hash. One of app id, app key or timestamp is incorrect.
204 Invalid app id.
205 The app domain is not registered.
206 The timestamp is older than 30 minutes.
HANDLING THE RESPONSE
DigiLocker workflow returns a public url of the document selected by the user from his/her
account. The client application must retrieve the document from this url and save it at a
secure location. The client application must provide an http service to save extract and save
the file from the url. The javascript library automatically calls this http service once the
DigiLocker service returns the url. The service must comply with following specification.
DESCRIPTION
This service will be provided by the client application over https.
URL STRUCTURE
https://clientapp.gov.in/upload
METHOD POST
PARAMETERS
• user_ref (required ) DigiLocker library passes a unique reference that can be
associated with this instance of the client web page. This can be used to associate the
file with a user sharing the file.
• doc_id (required ) This is the id value of the “Choose from DigiLocker” button.
This can be associated with the type of document the user is uploading such as
proof of identity (poi) or proof of address (poa).
• doc_url (required ) This is the public url of the document shared by the user from
DigiLocker.
Requester Specification
9
FORMAT
{
'user_ref' : YOUR_USER_REF,
'doc_id' : YOUR_DOC_ID,
'doc_url' : DOCUMENT_URL
}
RETURN
The service should return ‘SUCCESS’ if the file is successfully stored or ‘FAILURE’ in
case of failure.

More Related Content

What's hot

report
reportreport
report
Hirra Sultan
 
Eucalyptus, Nimbus & OpenNebula
Eucalyptus, Nimbus & OpenNebulaEucalyptus, Nimbus & OpenNebula
Eucalyptus, Nimbus & OpenNebula
Amar Myana
 
Food Traceability using Blockchain
Food Traceability using BlockchainFood Traceability using Blockchain
Food Traceability using Blockchain
Johannes Ahlmann
 
Building Aneka clouds.ppt
Building Aneka clouds.pptBuilding Aneka clouds.ppt
Building Aneka clouds.ppt
Dr. Vanajaroselin Chirchi
 
Computer Network notes (handwritten) UNIT 1
Computer Network notes (handwritten) UNIT 1Computer Network notes (handwritten) UNIT 1
Computer Network notes (handwritten) UNIT 1
NANDINI SHARMA
 
Presentation
PresentationPresentation
Presentation
Hirra Sultan
 
Blockchain Intro to Hyperledger Fabric
Blockchain Intro to Hyperledger Fabric Blockchain Intro to Hyperledger Fabric
Blockchain Intro to Hyperledger Fabric
Araf Karsh Hamid
 
Web mining tools
Web mining toolsWeb mining tools
Web mining tools
Sujata Regoti
 
Open Source Ajax Solution @OSDC.tw 2009
Open Source Ajax  Solution @OSDC.tw 2009Open Source Ajax  Solution @OSDC.tw 2009
Open Source Ajax Solution @OSDC.tw 2009
Robbie Cheng
 
MapReduce Programming Model
MapReduce Programming ModelMapReduce Programming Model
MapReduce Programming Model
AdarshaDhakal
 
Multiplayer Online Gaming
Multiplayer Online GamingMultiplayer Online Gaming
Multiplayer Online Gaming
chetnamistry
 
Cloud computing
Cloud computingCloud computing
Cloud computing
Arar Fahem
 
Ppt on blockchain technology
Ppt on blockchain technologyPpt on blockchain technology
Ppt on blockchain technology
RATAN AGARWALA
 
Architecture of operating system
Architecture of operating systemArchitecture of operating system
Architecture of operating system
Supriya Kumari
 
Blockchain technology ppt
Blockchain technology pptBlockchain technology ppt
Blockchain technology ppt
asrithak
 
Block chain technology and its applications
Block chain technology and its applications Block chain technology and its applications
Block chain technology and its applications
ABHISHEK JAIN
 
MHEG
MHEGMHEG
Distributed System - Security
Distributed System - SecurityDistributed System - Security
Distributed System - Security
Harshana Madusanka Jayamaha
 
Blockchain in Healthcare
Blockchain in Healthcare Blockchain in Healthcare
Blockchain in Healthcare
Alex Tsado
 
Examples of Smart Contracts
Examples of Smart ContractsExamples of Smart Contracts
Examples of Smart Contracts
101 Blockchains
 

What's hot (20)

report
reportreport
report
 
Eucalyptus, Nimbus & OpenNebula
Eucalyptus, Nimbus & OpenNebulaEucalyptus, Nimbus & OpenNebula
Eucalyptus, Nimbus & OpenNebula
 
Food Traceability using Blockchain
Food Traceability using BlockchainFood Traceability using Blockchain
Food Traceability using Blockchain
 
Building Aneka clouds.ppt
Building Aneka clouds.pptBuilding Aneka clouds.ppt
Building Aneka clouds.ppt
 
Computer Network notes (handwritten) UNIT 1
Computer Network notes (handwritten) UNIT 1Computer Network notes (handwritten) UNIT 1
Computer Network notes (handwritten) UNIT 1
 
Presentation
PresentationPresentation
Presentation
 
Blockchain Intro to Hyperledger Fabric
Blockchain Intro to Hyperledger Fabric Blockchain Intro to Hyperledger Fabric
Blockchain Intro to Hyperledger Fabric
 
Web mining tools
Web mining toolsWeb mining tools
Web mining tools
 
Open Source Ajax Solution @OSDC.tw 2009
Open Source Ajax  Solution @OSDC.tw 2009Open Source Ajax  Solution @OSDC.tw 2009
Open Source Ajax Solution @OSDC.tw 2009
 
MapReduce Programming Model
MapReduce Programming ModelMapReduce Programming Model
MapReduce Programming Model
 
Multiplayer Online Gaming
Multiplayer Online GamingMultiplayer Online Gaming
Multiplayer Online Gaming
 
Cloud computing
Cloud computingCloud computing
Cloud computing
 
Ppt on blockchain technology
Ppt on blockchain technologyPpt on blockchain technology
Ppt on blockchain technology
 
Architecture of operating system
Architecture of operating systemArchitecture of operating system
Architecture of operating system
 
Blockchain technology ppt
Blockchain technology pptBlockchain technology ppt
Blockchain technology ppt
 
Block chain technology and its applications
Block chain technology and its applications Block chain technology and its applications
Block chain technology and its applications
 
MHEG
MHEGMHEG
MHEG
 
Distributed System - Security
Distributed System - SecurityDistributed System - Security
Distributed System - Security
 
Blockchain in Healthcare
Blockchain in Healthcare Blockchain in Healthcare
Blockchain in Healthcare
 
Examples of Smart Contracts
Examples of Smart ContractsExamples of Smart Contracts
Examples of Smart Contracts
 

Similar to Digital Locker Requester API Specification v1 0

DevConf.CZ 2020 @ Brno, Czech Republic : WebAuthn support for keycloak
DevConf.CZ 2020 @ Brno, Czech Republic : WebAuthn support for keycloakDevConf.CZ 2020 @ Brno, Czech Republic : WebAuthn support for keycloak
DevConf.CZ 2020 @ Brno, Czech Republic : WebAuthn support for keycloak
Hitachi, Ltd. OSS Solution Center.
 
Azure AD B2C Webinar Series: Custom Policies Part 2 Policy Walkthrough
Azure AD B2C Webinar Series: Custom Policies Part 2 Policy WalkthroughAzure AD B2C Webinar Series: Custom Policies Part 2 Policy Walkthrough
Azure AD B2C Webinar Series: Custom Policies Part 2 Policy Walkthrough
Vinu Gunasekaran
 
Azure AD B2C Webinar Series: Custom Policies Part 1
Azure AD B2C Webinar Series: Custom Policies Part 1Azure AD B2C Webinar Series: Custom Policies Part 1
Azure AD B2C Webinar Series: Custom Policies Part 1
Vinu Gunasekaran
 
Soap toolkits
Soap toolkitsSoap toolkits
Soap toolkits
Aravindharamanan S
 
Automatizacion de Procesos en Modelos Tabulares
Automatizacion de Procesos en Modelos TabularesAutomatizacion de Procesos en Modelos Tabulares
Automatizacion de Procesos en Modelos Tabulares
Gaston Cruz
 
Submittal -User Manual
Submittal -User ManualSubmittal -User Manual
Submittal -User Manual
Niyas Sulaiman
 
A Detailed Guide to Securing React applications with Keycloak - WalkingTree ...
A Detailed Guide to Securing React applications with Keycloak  - WalkingTree ...A Detailed Guide to Securing React applications with Keycloak  - WalkingTree ...
A Detailed Guide to Securing React applications with Keycloak - WalkingTree ...
Ganesh Kumar
 
Microsoft Graph API with OutSystems Event Subscriptions
Microsoft Graph API with OutSystems Event SubscriptionsMicrosoft Graph API with OutSystems Event Subscriptions
Microsoft Graph API with OutSystems Event Subscriptions
Stefan Weber
 
Microsoft AZ-204 Exam Dumps
Microsoft AZ-204 Exam DumpsMicrosoft AZ-204 Exam Dumps
Microsoft AZ-204 Exam Dumps
Study Material
 
RESTful services and OAUTH protocol in IoT
RESTful services and OAUTH protocol in IoTRESTful services and OAUTH protocol in IoT
RESTful services and OAUTH protocol in IoT
Yakov Fain
 
OAuth with Salesforce - Demystified
OAuth with Salesforce - DemystifiedOAuth with Salesforce - Demystified
OAuth with Salesforce - Demystified
Calvin Noronha
 
Building Push Triggers for Logic Apps
Building Push Triggers for Logic AppsBuilding Push Triggers for Logic Apps
Building Push Triggers for Logic Apps
BizTalk360
 
Microsoft identity platform and device authorization flow to use azure servic...
Microsoft identity platform and device authorization flow to use azure servic...Microsoft identity platform and device authorization flow to use azure servic...
Microsoft identity platform and device authorization flow to use azure servic...
Sunil kumar Mohanty
 
Web PenTest Sample Report
Web PenTest Sample ReportWeb PenTest Sample Report
Web PenTest Sample Report
Octogence
 
What API Specifications and Tools Help Engineers to Construct a High-Security...
What API Specifications and Tools Help Engineers to Construct a High-Security...What API Specifications and Tools Help Engineers to Construct a High-Security...
What API Specifications and Tools Help Engineers to Construct a High-Security...
Hitachi, Ltd. OSS Solution Center.
 
How to integrate portlet as widget in liferay to any website application
How to integrate portlet as widget in liferay to any website applicationHow to integrate portlet as widget in liferay to any website application
How to integrate portlet as widget in liferay to any website application
Azilen Technologies Pvt. Ltd.
 
High level design document template
High level design document templateHigh level design document template
High level design document template
anosha jamshed
 
Microservice security with spring security 5.1,Oauth 2.0 and open id connect
Microservice security with spring security 5.1,Oauth 2.0 and open id connect Microservice security with spring security 5.1,Oauth 2.0 and open id connect
Microservice security with spring security 5.1,Oauth 2.0 and open id connect
Nilanjan Roy
 
DIGITAL TWIN FRAMEWORK FOR SUPPLYCHAIN PROCESS
DIGITAL TWIN FRAMEWORK FOR SUPPLYCHAIN PROCESSDIGITAL TWIN FRAMEWORK FOR SUPPLYCHAIN PROCESS
DIGITAL TWIN FRAMEWORK FOR SUPPLYCHAIN PROCESS
IRJET Journal
 
User id installation and configuration
User id installation and configurationUser id installation and configuration
User id installation and configuration
Alberto Rivai
 

Similar to Digital Locker Requester API Specification v1 0 (20)

DevConf.CZ 2020 @ Brno, Czech Republic : WebAuthn support for keycloak
DevConf.CZ 2020 @ Brno, Czech Republic : WebAuthn support for keycloakDevConf.CZ 2020 @ Brno, Czech Republic : WebAuthn support for keycloak
DevConf.CZ 2020 @ Brno, Czech Republic : WebAuthn support for keycloak
 
Azure AD B2C Webinar Series: Custom Policies Part 2 Policy Walkthrough
Azure AD B2C Webinar Series: Custom Policies Part 2 Policy WalkthroughAzure AD B2C Webinar Series: Custom Policies Part 2 Policy Walkthrough
Azure AD B2C Webinar Series: Custom Policies Part 2 Policy Walkthrough
 
Azure AD B2C Webinar Series: Custom Policies Part 1
Azure AD B2C Webinar Series: Custom Policies Part 1Azure AD B2C Webinar Series: Custom Policies Part 1
Azure AD B2C Webinar Series: Custom Policies Part 1
 
Soap toolkits
Soap toolkitsSoap toolkits
Soap toolkits
 
Automatizacion de Procesos en Modelos Tabulares
Automatizacion de Procesos en Modelos TabularesAutomatizacion de Procesos en Modelos Tabulares
Automatizacion de Procesos en Modelos Tabulares
 
Submittal -User Manual
Submittal -User ManualSubmittal -User Manual
Submittal -User Manual
 
A Detailed Guide to Securing React applications with Keycloak - WalkingTree ...
A Detailed Guide to Securing React applications with Keycloak  - WalkingTree ...A Detailed Guide to Securing React applications with Keycloak  - WalkingTree ...
A Detailed Guide to Securing React applications with Keycloak - WalkingTree ...
 
Microsoft Graph API with OutSystems Event Subscriptions
Microsoft Graph API with OutSystems Event SubscriptionsMicrosoft Graph API with OutSystems Event Subscriptions
Microsoft Graph API with OutSystems Event Subscriptions
 
Microsoft AZ-204 Exam Dumps
Microsoft AZ-204 Exam DumpsMicrosoft AZ-204 Exam Dumps
Microsoft AZ-204 Exam Dumps
 
RESTful services and OAUTH protocol in IoT
RESTful services and OAUTH protocol in IoTRESTful services and OAUTH protocol in IoT
RESTful services and OAUTH protocol in IoT
 
OAuth with Salesforce - Demystified
OAuth with Salesforce - DemystifiedOAuth with Salesforce - Demystified
OAuth with Salesforce - Demystified
 
Building Push Triggers for Logic Apps
Building Push Triggers for Logic AppsBuilding Push Triggers for Logic Apps
Building Push Triggers for Logic Apps
 
Microsoft identity platform and device authorization flow to use azure servic...
Microsoft identity platform and device authorization flow to use azure servic...Microsoft identity platform and device authorization flow to use azure servic...
Microsoft identity platform and device authorization flow to use azure servic...
 
Web PenTest Sample Report
Web PenTest Sample ReportWeb PenTest Sample Report
Web PenTest Sample Report
 
What API Specifications and Tools Help Engineers to Construct a High-Security...
What API Specifications and Tools Help Engineers to Construct a High-Security...What API Specifications and Tools Help Engineers to Construct a High-Security...
What API Specifications and Tools Help Engineers to Construct a High-Security...
 
How to integrate portlet as widget in liferay to any website application
How to integrate portlet as widget in liferay to any website applicationHow to integrate portlet as widget in liferay to any website application
How to integrate portlet as widget in liferay to any website application
 
High level design document template
High level design document templateHigh level design document template
High level design document template
 
Microservice security with spring security 5.1,Oauth 2.0 and open id connect
Microservice security with spring security 5.1,Oauth 2.0 and open id connect Microservice security with spring security 5.1,Oauth 2.0 and open id connect
Microservice security with spring security 5.1,Oauth 2.0 and open id connect
 
DIGITAL TWIN FRAMEWORK FOR SUPPLYCHAIN PROCESS
DIGITAL TWIN FRAMEWORK FOR SUPPLYCHAIN PROCESSDIGITAL TWIN FRAMEWORK FOR SUPPLYCHAIN PROCESS
DIGITAL TWIN FRAMEWORK FOR SUPPLYCHAIN PROCESS
 
User id installation and configuration
User id installation and configurationUser id installation and configuration
User id installation and configuration
 

More from Amit Ranjan

doc sample.docx
doc sample.docxdoc sample.docx
doc sample.docx
Amit Ranjan
 
designing.ppt
designing.pptdesigning.ppt
designing.ppt
Amit Ranjan
 
turef67wea.pptx
turef67wea.pptxturef67wea.pptx
turef67wea.pptx
Amit Ranjan
 
Pics - World Government Summit Dubai (#WGS2023).pptx
Pics - World Government Summit Dubai (#WGS2023).pptxPics - World Government Summit Dubai (#WGS2023).pptx
Pics - World Government Summit Dubai (#WGS2023).pptx
Amit Ranjan
 
Evaluating New Age Startups: Profitability Vs Growth
Evaluating New Age Startups: Profitability Vs GrowthEvaluating New Age Startups: Profitability Vs Growth
Evaluating New Age Startups: Profitability Vs Growth
Amit Ranjan
 
The Art and Science of Building World Class Technology Products
The Art and Science of Building World Class Technology ProductsThe Art and Science of Building World Class Technology Products
The Art and Science of Building World Class Technology Products
Amit Ranjan
 
Demo: How to get your Digital Aadhaar (eAadhaar) in DigiLocker
Demo: How to get your Digital Aadhaar (eAadhaar) in DigiLockerDemo: How to get your Digital Aadhaar (eAadhaar) in DigiLocker
Demo: How to get your Digital Aadhaar (eAadhaar) in DigiLocker
Amit Ranjan
 
How Users Can Get their Digital Driving License & Vehicle Registration from D...
How Users Can Get their Digital Driving License & Vehicle Registration from D...How Users Can Get their Digital Driving License & Vehicle Registration from D...
How Users Can Get their Digital Driving License & Vehicle Registration from D...
Amit Ranjan
 
Government of India Gazette Notification - The Information Technology (Preser...
Government of India Gazette Notification - The Information Technology (Preser...Government of India Gazette Notification - The Information Technology (Preser...
Government of India Gazette Notification - The Information Technology (Preser...
Amit Ranjan
 
Policy on Open Application Programming Interfaces (APIs) for Government of India
Policy on Open Application Programming Interfaces (APIs) for Government of IndiaPolicy on Open Application Programming Interfaces (APIs) for Government of India
Policy on Open Application Programming Interfaces (APIs) for Government of India
Amit Ranjan
 
Policy on Adoption of Open Source Software for Government of India
Policy on Adoption of Open Source Software for Government of IndiaPolicy on Adoption of Open Source Software for Government of India
Policy on Adoption of Open Source Software for Government of India
Amit Ranjan
 
India Stack - Social Impact at Scale
India Stack - Social Impact at ScaleIndia Stack - Social Impact at Scale
India Stack - Social Impact at Scale
Amit Ranjan
 
Technical Specifications DLTS Ver 2.3
Technical Specifications DLTS Ver 2.3Technical Specifications DLTS Ver 2.3
Technical Specifications DLTS Ver 2.3
Amit Ranjan
 
eSign Brochure v1.5
eSign Brochure v1.5eSign Brochure v1.5
eSign Brochure v1.5
Amit Ranjan
 
Digital Locker User Manual
Digital Locker User ManualDigital Locker User Manual
Digital Locker User Manual
Amit Ranjan
 
Digital Locker Intro Deck
Digital Locker Intro DeckDigital Locker Intro Deck
Digital Locker Intro Deck
Amit Ranjan
 
Digital Locker Dedicated Repository API Specification v1 4
Digital Locker Dedicated Repository API Specification v1 4Digital Locker Dedicated Repository API Specification v1 4
Digital Locker Dedicated Repository API Specification v1 4
Amit Ranjan
 
Bulk and Run Time Digital Signing v1.0
Bulk and Run Time Digital Signing v1.0Bulk and Run Time Digital Signing v1.0
Bulk and Run Time Digital Signing v1.0
Amit Ranjan
 
Policy On Collaborative Application Development by Opening the Source Code of...
Policy On Collaborative Application Development by Opening the Source Code of...Policy On Collaborative Application Development by Opening the Source Code of...
Policy On Collaborative Application Development by Opening the Source Code of...
Amit Ranjan
 
Digital India - Govt of India's flagship program for digital empowerment of I...
Digital India - Govt of India's flagship program for digital empowerment of I...Digital India - Govt of India's flagship program for digital empowerment of I...
Digital India - Govt of India's flagship program for digital empowerment of I...
Amit Ranjan
 

More from Amit Ranjan (20)

doc sample.docx
doc sample.docxdoc sample.docx
doc sample.docx
 
designing.ppt
designing.pptdesigning.ppt
designing.ppt
 
turef67wea.pptx
turef67wea.pptxturef67wea.pptx
turef67wea.pptx
 
Pics - World Government Summit Dubai (#WGS2023).pptx
Pics - World Government Summit Dubai (#WGS2023).pptxPics - World Government Summit Dubai (#WGS2023).pptx
Pics - World Government Summit Dubai (#WGS2023).pptx
 
Evaluating New Age Startups: Profitability Vs Growth
Evaluating New Age Startups: Profitability Vs GrowthEvaluating New Age Startups: Profitability Vs Growth
Evaluating New Age Startups: Profitability Vs Growth
 
The Art and Science of Building World Class Technology Products
The Art and Science of Building World Class Technology ProductsThe Art and Science of Building World Class Technology Products
The Art and Science of Building World Class Technology Products
 
Demo: How to get your Digital Aadhaar (eAadhaar) in DigiLocker
Demo: How to get your Digital Aadhaar (eAadhaar) in DigiLockerDemo: How to get your Digital Aadhaar (eAadhaar) in DigiLocker
Demo: How to get your Digital Aadhaar (eAadhaar) in DigiLocker
 
How Users Can Get their Digital Driving License & Vehicle Registration from D...
How Users Can Get their Digital Driving License & Vehicle Registration from D...How Users Can Get their Digital Driving License & Vehicle Registration from D...
How Users Can Get their Digital Driving License & Vehicle Registration from D...
 
Government of India Gazette Notification - The Information Technology (Preser...
Government of India Gazette Notification - The Information Technology (Preser...Government of India Gazette Notification - The Information Technology (Preser...
Government of India Gazette Notification - The Information Technology (Preser...
 
Policy on Open Application Programming Interfaces (APIs) for Government of India
Policy on Open Application Programming Interfaces (APIs) for Government of IndiaPolicy on Open Application Programming Interfaces (APIs) for Government of India
Policy on Open Application Programming Interfaces (APIs) for Government of India
 
Policy on Adoption of Open Source Software for Government of India
Policy on Adoption of Open Source Software for Government of IndiaPolicy on Adoption of Open Source Software for Government of India
Policy on Adoption of Open Source Software for Government of India
 
India Stack - Social Impact at Scale
India Stack - Social Impact at ScaleIndia Stack - Social Impact at Scale
India Stack - Social Impact at Scale
 
Technical Specifications DLTS Ver 2.3
Technical Specifications DLTS Ver 2.3Technical Specifications DLTS Ver 2.3
Technical Specifications DLTS Ver 2.3
 
eSign Brochure v1.5
eSign Brochure v1.5eSign Brochure v1.5
eSign Brochure v1.5
 
Digital Locker User Manual
Digital Locker User ManualDigital Locker User Manual
Digital Locker User Manual
 
Digital Locker Intro Deck
Digital Locker Intro DeckDigital Locker Intro Deck
Digital Locker Intro Deck
 
Digital Locker Dedicated Repository API Specification v1 4
Digital Locker Dedicated Repository API Specification v1 4Digital Locker Dedicated Repository API Specification v1 4
Digital Locker Dedicated Repository API Specification v1 4
 
Bulk and Run Time Digital Signing v1.0
Bulk and Run Time Digital Signing v1.0Bulk and Run Time Digital Signing v1.0
Bulk and Run Time Digital Signing v1.0
 
Policy On Collaborative Application Development by Opening the Source Code of...
Policy On Collaborative Application Development by Opening the Source Code of...Policy On Collaborative Application Development by Opening the Source Code of...
Policy On Collaborative Application Development by Opening the Source Code of...
 
Digital India - Govt of India's flagship program for digital empowerment of I...
Digital India - Govt of India's flagship program for digital empowerment of I...Digital India - Govt of India's flagship program for digital empowerment of I...
Digital India - Govt of India's flagship program for digital empowerment of I...
 

Recently uploaded

Girls Call Kanpur 000XX00000 Girls Service Cash Payment Free Home Delivery
Girls Call Kanpur 000XX00000 Girls Service Cash Payment Free Home DeliveryGirls Call Kanpur 000XX00000 Girls Service Cash Payment Free Home Delivery
Girls Call Kanpur 000XX00000 Girls Service Cash Payment Free Home Delivery
gargpooja2024#s07
 
Girls Call Nashik 000XX00000 Girls Service Cash Payment Free Home Delivery
Girls Call Nashik 000XX00000 Girls Service Cash Payment Free Home DeliveryGirls Call Nashik 000XX00000 Girls Service Cash Payment Free Home Delivery
Girls Call Nashik 000XX00000 Girls Service Cash Payment Free Home Delivery
gargkajal2024#G05
 
Building Stronger Relationships with BLG Mobile.pptx
Building Stronger Relationships with BLG Mobile.pptxBuilding Stronger Relationships with BLG Mobile.pptx
Building Stronger Relationships with BLG Mobile.pptx
Bloomerang
 
2024: The FAR - Federal Acquisition Regulations, Part 47
2024: The FAR - Federal Acquisition Regulations, Part 472024: The FAR - Federal Acquisition Regulations, Part 47
2024: The FAR - Federal Acquisition Regulations, Part 47
JSchaus & Associates
 
Lucknow Girls Call Singar Nagar 08630512678 Girls Call Service
Lucknow Girls Call Singar Nagar 08630512678  Girls Call ServiceLucknow Girls Call Singar Nagar 08630512678  Girls Call Service
Lucknow Girls Call Singar Nagar 08630512678 Girls Call Service
anilsa9823
 
Pune Girls Call Pune 0X0000000X Payment On Delevery Cash Hot Premium Genuine ...
Pune Girls Call Pune 0X0000000X Payment On Delevery Cash Hot Premium Genuine ...Pune Girls Call Pune 0X0000000X Payment On Delevery Cash Hot Premium Genuine ...
Pune Girls Call Pune 0X0000000X Payment On Delevery Cash Hot Premium Genuine ...
seenaoberoi
 
Celebrity Girls Call Navi Mumbai 🛵🚡9820252231 💃 Choose Best And Top Girl Serv...
Celebrity Girls Call Navi Mumbai 🛵🚡9820252231 💃 Choose Best And Top Girl Serv...Celebrity Girls Call Navi Mumbai 🛵🚡9820252231 💃 Choose Best And Top Girl Serv...
Celebrity Girls Call Navi Mumbai 🛵🚡9820252231 💃 Choose Best And Top Girl Serv...
902basic
 
3What is Standing Deposit Facility (SDF)?
3What is Standing Deposit Facility (SDF)?3What is Standing Deposit Facility (SDF)?
Accounting Basics For Clerks And RFOs (UPDATED 2024)
Accounting Basics For Clerks And RFOs (UPDATED 2024)Accounting Basics For Clerks And RFOs (UPDATED 2024)
Accounting Basics For Clerks And RFOs (UPDATED 2024)
Scribe
 
Connaught Place @Girls @Call WhatsApp Numbers 🫦0000XX0000🫦 List For Friendshi...
Connaught Place @Girls @Call WhatsApp Numbers 🫦0000XX0000🫦 List For Friendshi...Connaught Place @Girls @Call WhatsApp Numbers 🫦0000XX0000🫦 List For Friendshi...
Connaught Place @Girls @Call WhatsApp Numbers 🫦0000XX0000🫦 List For Friendshi...
paridubey2024#G05
 
Girls Call Kolkata 000XX00000 Provide Best And Top Girl Service And No1 in City
Girls Call Kolkata 000XX00000 Provide Best And Top Girl Service And No1 in CityGirls Call Kolkata 000XX00000 Provide Best And Top Girl Service And No1 in City
Girls Call Kolkata 000XX00000 Provide Best And Top Girl Service And No1 in City
sexytaniya455
 
2024: The FAR - Federal Acquisition Regulations, Part 48
2024: The FAR - Federal Acquisition Regulations, Part 482024: The FAR - Federal Acquisition Regulations, Part 48
2024: The FAR - Federal Acquisition Regulations, Part 48
JSchaus & Associates
 
Highland Hills Comprehensive Plan Public Meeting #2
Highland Hills Comprehensive Plan Public Meeting #2Highland Hills Comprehensive Plan Public Meeting #2
Highland Hills Comprehensive Plan Public Meeting #2
Cuyahoga County Planning Commission
 
Canadian Immigration Tracker - Key Slides - May 2024.pdf
Canadian Immigration Tracker - Key Slides - May 2024.pdfCanadian Immigration Tracker - Key Slides - May 2024.pdf
Canadian Immigration Tracker - Key Slides - May 2024.pdf
Andrew Griffith
 
Vadodara Girls Call Vadodara 0X0000000X Unlimited Short Providing Girls Servi...
Vadodara Girls Call Vadodara 0X0000000X Unlimited Short Providing Girls Servi...Vadodara Girls Call Vadodara 0X0000000X Unlimited Short Providing Girls Servi...
Vadodara Girls Call Vadodara 0X0000000X Unlimited Short Providing Girls Servi...
sabanihahanshni
 
RBI Circular on LRS (Liberalized Remittance Scheme)
RBI Circular on LRS (Liberalized Remittance Scheme)RBI Circular on LRS (Liberalized Remittance Scheme)
RBI Circular on LRS (Liberalized Remittance Scheme)
Gaurav Kanudawala
 
Lucknow Girls Call Telibagh 08630512678 Girls Call Service
Lucknow Girls Call Telibagh 08630512678  Girls Call ServiceLucknow Girls Call Telibagh 08630512678  Girls Call Service
Lucknow Girls Call Telibagh 08630512678 Girls Call Service
annarivihqrika
 
Day care centers for poor childrens.pptx
Day care centers for poor childrens.pptxDay care centers for poor childrens.pptx
Day care centers for poor childrens.pptx
SERUDS INDIA
 
BBW Girls Call Navi Mumbai 9930245274 Provide Best And Top Girl Service And N...
BBW Girls Call Navi Mumbai 9930245274 Provide Best And Top Girl Service And N...BBW Girls Call Navi Mumbai 9930245274 Provide Best And Top Girl Service And N...
BBW Girls Call Navi Mumbai 9930245274 Provide Best And Top Girl Service And N...
sharonblush
 
Exclusive Girls Call Noida 9873940964 Provide Best And Top Girl Service And N...
Exclusive Girls Call Noida 9873940964 Provide Best And Top Girl Service And N...Exclusive Girls Call Noida 9873940964 Provide Best And Top Girl Service And N...
Exclusive Girls Call Noida 9873940964 Provide Best And Top Girl Service And N...
Ak47
 

Recently uploaded (20)

Girls Call Kanpur 000XX00000 Girls Service Cash Payment Free Home Delivery
Girls Call Kanpur 000XX00000 Girls Service Cash Payment Free Home DeliveryGirls Call Kanpur 000XX00000 Girls Service Cash Payment Free Home Delivery
Girls Call Kanpur 000XX00000 Girls Service Cash Payment Free Home Delivery
 
Girls Call Nashik 000XX00000 Girls Service Cash Payment Free Home Delivery
Girls Call Nashik 000XX00000 Girls Service Cash Payment Free Home DeliveryGirls Call Nashik 000XX00000 Girls Service Cash Payment Free Home Delivery
Girls Call Nashik 000XX00000 Girls Service Cash Payment Free Home Delivery
 
Building Stronger Relationships with BLG Mobile.pptx
Building Stronger Relationships with BLG Mobile.pptxBuilding Stronger Relationships with BLG Mobile.pptx
Building Stronger Relationships with BLG Mobile.pptx
 
2024: The FAR - Federal Acquisition Regulations, Part 47
2024: The FAR - Federal Acquisition Regulations, Part 472024: The FAR - Federal Acquisition Regulations, Part 47
2024: The FAR - Federal Acquisition Regulations, Part 47
 
Lucknow Girls Call Singar Nagar 08630512678 Girls Call Service
Lucknow Girls Call Singar Nagar 08630512678  Girls Call ServiceLucknow Girls Call Singar Nagar 08630512678  Girls Call Service
Lucknow Girls Call Singar Nagar 08630512678 Girls Call Service
 
Pune Girls Call Pune 0X0000000X Payment On Delevery Cash Hot Premium Genuine ...
Pune Girls Call Pune 0X0000000X Payment On Delevery Cash Hot Premium Genuine ...Pune Girls Call Pune 0X0000000X Payment On Delevery Cash Hot Premium Genuine ...
Pune Girls Call Pune 0X0000000X Payment On Delevery Cash Hot Premium Genuine ...
 
Celebrity Girls Call Navi Mumbai 🛵🚡9820252231 💃 Choose Best And Top Girl Serv...
Celebrity Girls Call Navi Mumbai 🛵🚡9820252231 💃 Choose Best And Top Girl Serv...Celebrity Girls Call Navi Mumbai 🛵🚡9820252231 💃 Choose Best And Top Girl Serv...
Celebrity Girls Call Navi Mumbai 🛵🚡9820252231 💃 Choose Best And Top Girl Serv...
 
3What is Standing Deposit Facility (SDF)?
3What is Standing Deposit Facility (SDF)?3What is Standing Deposit Facility (SDF)?
3What is Standing Deposit Facility (SDF)?
 
Accounting Basics For Clerks And RFOs (UPDATED 2024)
Accounting Basics For Clerks And RFOs (UPDATED 2024)Accounting Basics For Clerks And RFOs (UPDATED 2024)
Accounting Basics For Clerks And RFOs (UPDATED 2024)
 
Connaught Place @Girls @Call WhatsApp Numbers 🫦0000XX0000🫦 List For Friendshi...
Connaught Place @Girls @Call WhatsApp Numbers 🫦0000XX0000🫦 List For Friendshi...Connaught Place @Girls @Call WhatsApp Numbers 🫦0000XX0000🫦 List For Friendshi...
Connaught Place @Girls @Call WhatsApp Numbers 🫦0000XX0000🫦 List For Friendshi...
 
Girls Call Kolkata 000XX00000 Provide Best And Top Girl Service And No1 in City
Girls Call Kolkata 000XX00000 Provide Best And Top Girl Service And No1 in CityGirls Call Kolkata 000XX00000 Provide Best And Top Girl Service And No1 in City
Girls Call Kolkata 000XX00000 Provide Best And Top Girl Service And No1 in City
 
2024: The FAR - Federal Acquisition Regulations, Part 48
2024: The FAR - Federal Acquisition Regulations, Part 482024: The FAR - Federal Acquisition Regulations, Part 48
2024: The FAR - Federal Acquisition Regulations, Part 48
 
Highland Hills Comprehensive Plan Public Meeting #2
Highland Hills Comprehensive Plan Public Meeting #2Highland Hills Comprehensive Plan Public Meeting #2
Highland Hills Comprehensive Plan Public Meeting #2
 
Canadian Immigration Tracker - Key Slides - May 2024.pdf
Canadian Immigration Tracker - Key Slides - May 2024.pdfCanadian Immigration Tracker - Key Slides - May 2024.pdf
Canadian Immigration Tracker - Key Slides - May 2024.pdf
 
Vadodara Girls Call Vadodara 0X0000000X Unlimited Short Providing Girls Servi...
Vadodara Girls Call Vadodara 0X0000000X Unlimited Short Providing Girls Servi...Vadodara Girls Call Vadodara 0X0000000X Unlimited Short Providing Girls Servi...
Vadodara Girls Call Vadodara 0X0000000X Unlimited Short Providing Girls Servi...
 
RBI Circular on LRS (Liberalized Remittance Scheme)
RBI Circular on LRS (Liberalized Remittance Scheme)RBI Circular on LRS (Liberalized Remittance Scheme)
RBI Circular on LRS (Liberalized Remittance Scheme)
 
Lucknow Girls Call Telibagh 08630512678 Girls Call Service
Lucknow Girls Call Telibagh 08630512678  Girls Call ServiceLucknow Girls Call Telibagh 08630512678  Girls Call Service
Lucknow Girls Call Telibagh 08630512678 Girls Call Service
 
Day care centers for poor childrens.pptx
Day care centers for poor childrens.pptxDay care centers for poor childrens.pptx
Day care centers for poor childrens.pptx
 
BBW Girls Call Navi Mumbai 9930245274 Provide Best And Top Girl Service And N...
BBW Girls Call Navi Mumbai 9930245274 Provide Best And Top Girl Service And N...BBW Girls Call Navi Mumbai 9930245274 Provide Best And Top Girl Service And N...
BBW Girls Call Navi Mumbai 9930245274 Provide Best And Top Girl Service And N...
 
Exclusive Girls Call Noida 9873940964 Provide Best And Top Girl Service And N...
Exclusive Girls Call Noida 9873940964 Provide Best And Top Girl Service And N...Exclusive Girls Call Noida 9873940964 Provide Best And Top Girl Service And N...
Exclusive Girls Call Noida 9873940964 Provide Best And Top Girl Service And N...
 

Digital Locker Requester API Specification v1 0

  • 1. Requester Specification Version 1.0 September 2015 A Digital India Initiative National e-Governance Division. Department of Electronics and Information Technology.
  • 2. Requester Specification 1 Revision History Version Date Author Comments 1.0 12/08/2015 Amit Savant (NeGD) Version 1.0 Released.
  • 3. Requester Specification 2 Table of Contents Revision History.......................................................................................................................................................1 Introduction...............................................................................................................................................................3 Requester Workflow..............................................................................................................................................3 Step 1: User clicks “Choose from DigiLocker” button on the client application........................3 Step 2: DigiLocker Requestor Widget pops up and prompts user to login. ................................4 Step 3: User logs in to the account and selects a file to share...........................................................4 Step 4: DigiLocker shares file with the client application and shows status message............5 Steps to Integrate Requester Workflow.........................................................................................................5 Step 1: Register as Requestor on DigiLocker...........................................................................................5 Step 2: Register Requestor Application and Domain on DigiLocker..............................................6 Step 3: Integrate DigiLocker Requestor Widget in your web application ...................................6 Integrating with Digital Locker..........................................................................................................................6 REQUESTER REGISTRATION ....................................................................................................................6 TRIGGERING DIGILOCKER FROM YOUR WEB PAGE.......................................................................7 HANDLING THE RESPONSE.......................................................................................................................8
  • 4. Requester Specification 3 Digital Locker Requester Specification Introduction This document provides detailed specification to integrate with Digital Locker as a Requester. The steps described in this document will be used by various departments to access users’ documents from their Digital Locker. This document assumes that the reader is aware of the Digital Locker application functionality. Requester Workflow Step 1: User clicks “Choose from DigiLocker” button on the client application.
  • 5. Requester Specification 4 Step 2: DigiLocker Requestor Widget pops up and prompts user to login. Step 3: User logs in to the account and selects a file to share.
  • 6. Requester Specification 5 Step 4: DigiLocker shares file with the client application and shows status message. Steps to Integrate Requester Workflow Step 1: Register as Requestor on DigiLocker
  • 7. Requester Specification 6 Step 2: Register Requestor Application and Domain on DigiLocker Step 3: Integrate DigiLocker Requestor Widget in your web application Integrating with Digital Locker REQUESTER REGISTRATION The first step in integrating with Digital Locker application is to register on Digital Locker as a Requester. On the successful registration, the Requester application must be registered
  • 8. Requester Specification 7 along with the domain of your application from which the requests to Digital Locker will be initiated. During the registration process you create an application id (app id) for your application. You are provided with an api key which is a secret key. The App Id and the api key are used to authenticate the request from your application. TRIGGERING DIGILOCKER FROM YOUR WEB PAGE DigiLocker provides a Requestor Widget to share files from DigiLocker. This widget can be launched with a button provided by DigiLocker Javascript library. The launches DigiLocker application login page in a popup. A user can login to his/her DigiLocker account to select a file that the user want to share with the requestor application. This button looks like this - Once you register as a Requester and register your application with Digital Locker, add following JavaScript snippet to your web page. <script src="jquery.min.js"></script> <script type="text/javascript" src="https://services.digitallocker.gov.in/requester/api/1/dl.js" id="dlshare" data-app-id="YOUR_APP_ID" data-app-hash="YOUR_APP_HASH" time-stamp=”TIMESTAMP” data-upload-url="YOUR_UPLOAD_URL"> </script> Please note that the DigiLocker library uses jQuery. So please download jquery.min.js file from jQuery.com and place it on your web server. Specify the path of this file in the above snippet in the src parameter of jQuery script. Provide app id that was provided during the application registration process in data-app- id parameter. Provide SHA-256 encrypted value of your app id, app key and the timestamp values in this sequence in data-app-hash parameter. Provide the url of the service that uploads the file from the public url of the document provided by Digital Locker in data-upload-url parameter. Please referto Handling The Response section below for more details. Provide a timestamp value in IST time zone in time-stamp parameter. This timestamp value must not be older than 30 minutes. To add the “Choose from DigiLocker” button to your page, add following line to your web page where you want to add the button. Provide a unique id for every instance of the button on your web page. The value of id can be used to identify the type of document being shared by a user.
  • 9. Requester Specification 8 <div class="share_fm_dl" id="attachment_poi"></div> If the integration is successful, the DigiLocker Requestor Widget will be launched and you will see the DigiLocker login page. If there is an error in the integration, the widget will show an authentication error and an error code. Following table lists the error codes. Code Description 203 Invalid app hash. One of app id, app key or timestamp is incorrect. 204 Invalid app id. 205 The app domain is not registered. 206 The timestamp is older than 30 minutes. HANDLING THE RESPONSE DigiLocker workflow returns a public url of the document selected by the user from his/her account. The client application must retrieve the document from this url and save it at a secure location. The client application must provide an http service to save extract and save the file from the url. The javascript library automatically calls this http service once the DigiLocker service returns the url. The service must comply with following specification. DESCRIPTION This service will be provided by the client application over https. URL STRUCTURE https://clientapp.gov.in/upload METHOD POST PARAMETERS • user_ref (required ) DigiLocker library passes a unique reference that can be associated with this instance of the client web page. This can be used to associate the file with a user sharing the file. • doc_id (required ) This is the id value of the “Choose from DigiLocker” button. This can be associated with the type of document the user is uploading such as proof of identity (poi) or proof of address (poa). • doc_url (required ) This is the public url of the document shared by the user from DigiLocker.
  • 10. Requester Specification 9 FORMAT { 'user_ref' : YOUR_USER_REF, 'doc_id' : YOUR_DOC_ID, 'doc_url' : DOCUMENT_URL } RETURN The service should return ‘SUCCESS’ if the file is successfully stored or ‘FAILURE’ in case of failure.