Discover Link On Init
curl --request POST \
--url https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"request_id": "<string>",
"txn_id": "<string>",
"error": {
"code": 123,
"message": "<string>"
},
"otp_expiry": "<string>",
"ref_num": "<string>"
}
'import requests
url = "https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init"
payload = {
"request_id": "<string>",
"txn_id": "<string>",
"error": {
"code": 123,
"message": "<string>"
},
"otp_expiry": "<string>",
"ref_num": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
request_id: '<string>',
txn_id: '<string>',
error: {code: 123, message: '<string>'},
otp_expiry: '<string>',
ref_num: '<string>'
})
};
fetch('https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"request_id\": \"<string>\",\n \"txn_id\": \"<string>\",\n \"error\": {\n \"code\": 123,\n \"message\": \"<string>\"\n },\n \"otp_expiry\": \"<string>\",\n \"ref_num\": \"<string>\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"request_id\": \"<string>\",\n \"txn_id\": \"<string>\",\n \"error\": {\n \"code\": 123,\n \"message\": \"<string>\"\n },\n \"otp_expiry\": \"<string>\",\n \"ref_num\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
require 'uri'
require 'net/http'
url = URI("https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"request_id\": \"<string>\",\n \"txn_id\": \"<string>\",\n \"error\": {\n \"code\": 123,\n \"message\": \"<string>\"\n },\n \"otp_expiry\": \"<string>\",\n \"ref_num\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"error": "<string>",
"source_error": {
"code": "<string>",
"message": "<string>"
}
}{
"code": 123,
"error": "<string>",
"source_error": {
"code": "<string>",
"message": "<string>"
}
}User initiated linking
Discover Link On Init
This API is used by HIP to initiate the linking of unlinked health records (care contexts). HIP must send an OTP and provide details such as OTP expiry and other related information.
POST
/
abdm
/
v1
/
care-contexts
/
discover
/
link
/
on-init
Discover Link On Init
curl --request POST \
--url https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"request_id": "<string>",
"txn_id": "<string>",
"error": {
"code": 123,
"message": "<string>"
},
"otp_expiry": "<string>",
"ref_num": "<string>"
}
'import requests
url = "https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init"
payload = {
"request_id": "<string>",
"txn_id": "<string>",
"error": {
"code": 123,
"message": "<string>"
},
"otp_expiry": "<string>",
"ref_num": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
request_id: '<string>',
txn_id: '<string>',
error: {code: 123, message: '<string>'},
otp_expiry: '<string>',
ref_num: '<string>'
})
};
fetch('https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"request_id\": \"<string>\",\n \"txn_id\": \"<string>\",\n \"error\": {\n \"code\": 123,\n \"message\": \"<string>\"\n },\n \"otp_expiry\": \"<string>\",\n \"ref_num\": \"<string>\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"request_id\": \"<string>\",\n \"txn_id\": \"<string>\",\n \"error\": {\n \"code\": 123,\n \"message\": \"<string>\"\n },\n \"otp_expiry\": \"<string>\",\n \"ref_num\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
require 'uri'
require 'net/http'
url = URI("https://api.eka.care/abdm/v1/care-contexts/discover/link/on-init")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"request_id\": \"<string>\",\n \"txn_id\": \"<string>\",\n \"error\": {\n \"code\": 123,\n \"message\": \"<string>\"\n },\n \"otp_expiry\": \"<string>\",\n \"ref_num\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"error": "<string>",
"source_error": {
"code": "<string>",
"message": "<string>"
}
}{
"code": 123,
"error": "<string>",
"source_error": {
"code": "<string>",
"message": "<string>"
}
}Call this API in response to the Link Initiation webhook, after you have generated and sent the OTP to the patient. Use the
request_id and txn_id from the webhook payload when constructing your response.Used in
Authorizations
Headers
Body
application/json
Response
No Content
Was this page helpful?

