/v0.5/links/link/on-init Payload

Hi
@Govind_Deshmukh @Shubhanshu_S
I need sample payload for /v0.5/links/link/on-init, In postman collection it’s not implemented.

in https://sandbox.abdm.gov.in/swagger/ndhm-hip.yaml the payload for this api as

{
  "requestId": "5f7a535d-a3fd-416b-b069-c97d021fbacd",
  "timestamp": "2022-07-27T05:07:37.512Z",
  "transactionId": "a1s2c932-2f70-3ds3-a3b5-2sfd46b12a18d", //transction id from link-init callback. ok
  "link": {
    "referenceNumber": "string", // is it patient refernece number ?
    "authenticationType": "DIRECT", // for otp, which is type?
    "meta": { //this is for otp only or ?
      "communicationMedium": "MOBILE",
      "communicationHint": "string", //which this means?
      "communicationExpiry": "2019-12-30T12:01:55Z" //expiry of ?
    }
  },
  "error": {
    "code": 1000,
    "message": "string"
  },
  "resp": {
    "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

please look the questions marked in the payload…


on-confirm also not implemented.

Need sample payload for all possiblities of data(direct auth, otp auth etc, if any)


The OTP send to the user (with /v0.5/links/link/on-init) on behalf of HIP or Gateway? can you confirm it also, please?


Thanks
SALAHUDHEEN

Hi @salahudheen,

Please check below request and response payload & use it.

/v0.5/links/link/init :-

curl -X POST “https://your-hrp-server.com/v0.5/links/link/init” -H “accept: /” -H “X-HIP-ID: dsgfs” -H “Content-Type: application/json” -d “{“requestId”:“3fa85f64-5717-4562-b3fc-2c963f66afa6”,“timestamp”:“2022-07-27T10:45:17.477Z”,“transactionId”:“3fa85f64-5717-4562-b3fc-2c963f66afa6”,“patient”:{“id”:“hinapatel79@ndhm”,“referenceNumber”:“TMH-PUID-001”,“careContexts”:[{“referenceNumber”:“string”}]}}”

/v0.5/links/link/on-init :-

curl -X POST “https://dev.abdm.gov.in/gateway/v0.5/links/link/on-init” -H “accept: /” -H “X-CM-ID: gfjf” -H “Content-Type: application/json” -d “{“requestId”:“5f7a535d-a3fd-416b-b069-c97d021fbacd”,“timestamp”:“2022-07-27T10:47:08.169Z”,“transactionId”:“a1s2c932-2f70-3ds3-a3b5-2sfd46b12a18d”,“link”:{“referenceNumber”:“string”,“authenticationType”:“DIRECT”,“meta”:{“communicationMedium”:“MOBILE”,“communicationHint”:“string”,“communicationExpiry”:“2019-12-30T12:01:55Z”}},“error”:{“code”:1000,“message”:“string”},“resp”:{“requestId”:“3fa85f64-5717-4562-b3fc-2c963f66afa6”}}”

Thanks,
Govind D.

Hi @Govind_Deshmukh

Actually i asked about the init and on-init for care context discovery and linking by patient.
Please check and update

Thanks
Salahudheen

@Govind_Deshmukh

Hi
Can you please check and update?

thanks
SALAHUDHEEN

Hi @salahudheen,
Please check its an mistake from my end now i have edited please check once & let me know.

Thanks,
Govind D.

Hi @Govind_Deshmukh

Thanks for reply.
can you check my question, and give reply to all the scenarios.

I also attached a sample payload, and please look at the questions attached to it.


Please explain the auth modes for the part of this linking(DIRECT, MEDIATED, etc… and actually i don’t know how this works)


thanks for help

regards
SALAHUDHEEN

Hi @salahudheen,

Please check below details.
{
“requestId”: “5f7a535d-a3fd-416b-b069-c97d021fbacd”,
“timestamp”: “2022-07-27T05:07:37.512Z”,
“transactionId”: “a1s2c932-2f70-3ds3-a3b5-2sfd46b12a18d”,
“link”: {
“referenceNumber”: “string”, // it is discovery refernece number its coming from /v1/care-context/discover
“authenticationType”: “DIRECT”, // for otp only if you are following demografic then MEDIATED
“meta”: { //this is for otp only
“communicationMedium”: “MOBILE”,
“communicationHint”: “string”, // for notification data
“communicationExpiry”: “2019-12-30T12:01:55Z” //expiry is provided by HIP
}
},
“error”: {
“code”: 1000,
“message”: “string”
},
“resp”: {
“requestId”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”
}
}

if still you have query then follow the below document link.


NDHM Sandbox (abdm.gov.in)

Hi @Govind_Deshmukh

Thanks for reply. I will check and update.

regards
Salahudheen

Hi @salahudheen,

Please update once the is resolved.

Thanks,
Govind D.

HI @Govind_Deshmukh

There is no referenceNumber received from /v0.5/care-contexts/discover call back received in my HIP.

{{CM_HOST}}/v1/care-context/discover(you provided above) and {{HIP_HOST}}/v0.5/care-contexts/discover are same?

can you please check and update…

Thanks
SLAHUDHEEN

hi @Govind_Deshmukh

can you update?

thanks
salahudheen

Hi @salahudheen,

Please provide your contact details to set call and will close your small small issues.

Thanks,
Govind D