Selfie प्राप्त करेंGET

create पर Human Plugin द्वारा लौटाई गई id से किसी process के लिए capture की गई selfie पढ़ें।

Markdown

GET /v1/processes/{id}/selfie

id create के जवाब का UUID है। request में कोई body और कोई query parameters नहीं हैं।

curl http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie

Human Plugin selfie की कोई प्रति नहीं रखता: हर call उसे दोबारा fetch करती है।

Response

200 OK, छवि base64 में और उसके type के साथ:

{
  "fileContents": "/9j/4AAQSkZJRgABAQAAAQABAAD…",
  "contentType": "image/jpeg"
}

इसे फ़ाइल के रूप में सहेजने के लिए:

curl -s http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie \
  | jq -r .fileContents | base64 -d > selfie.jpg

उपलब्धता

• selfie केवल उसी process के लिए होती है जिसमें वह थी: imageBase64 में भेजी गई या व्यक्ति से capture की गई।
• Journey flow में selfie तभी मौजूद होती है जब व्यक्ति उसे capture कर ले। तब तक request 400 के साथ अस्वीकार की जाती है, जिसका message process state must be finished से शुरू होता है। पहले process पढ़ें, और selfie तभी लें जब वह PROCESS_STATE_FINISHED हो जाए।
• process पूरी होने के बाद selfie सीमित समय तक उपलब्ध रहती है। यदि आपको इसकी बाद में ज़रूरत हो, तो इस response से इसे store कर लें।

छवि को संभालना

selfie बायोमेट्रिक डेटा है। Human Plugin इसे कभी store या log नहीं करता, और response Cache-Control: no-store के साथ भेजा जाता है। इसे अपने gateway और application logs से भी बाहर रखें।

Errors

Status	message	अर्थ
400	process state must be finished…	ऐसी Journey process जिसका capture अभी पूरा नहीं हुआ है। पहले process पढ़ें
404	PROCESS_NOT_FOUND	id UUID नहीं है या अज्ञात है
404	SELFIE_NOT_FOUND	process में कोई selfie नहीं है: कोई capture नहीं हुआ, वह शुरू होने से पहले विफल हो गई, या selfie अब उपलब्ध नहीं है
4xx	अस्वीकृति का message	request अस्वीकार की गई। कारण message और details में है
502	UPSTREAM_UNAVAILABLE	selfie समय पर fetch नहीं हो सकी। बाद में फिर कोशिश करें
503	DATABASE_UNAVAILABLE	database विफल हुआ। बाद में फिर कोशिश करें

Reads को retry करना सुरक्षित है। retry करने पर 404 नहीं बदलता।

आगे

Process का जीवनचक्र