मुख्य सामग्री पर जाएं
POST
curl

अवलोकन

जब आप किसी दूसरे प्रदाता से उपयोगकर्ता आयात करते हैं और हर व्यक्ति के लिए पहले से एक विश्वसनीय चेहरे की छवि आपके पास है, तब इस endpoint का उपयोग करें। उपयोगकर्ता अब भी आपके vendor_data से जुड़ा रहता है, लेकिन यह प्रोफ़ाइल अटैचमेंट endpoint लक्ष्य उपयोगकर्ता को स्पष्ट रूप से पहचानने के लिए didit_internal_id का उपयोग करता है।
यह सूची में चेहरा अपलोड करें से अलग है। प्रोफ़ाइल अपलोड किसी उपयोगकर्ता से चेहरा जोड़ता है, ताकि साक्ष्य, डुप्लिकेट पहचान और चेहरा खोज के लिए उसका उपयोग हो सके। सूची अपलोड चेहरे को चेहरा-प्रकार ब्लॉकलिस्ट में जोड़ता है, ताकि भविष्य के मिलान सत्र अस्वीकार किए जा सकें।

Endpoint

POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/

माइग्रेशन प्रवाह

1

उपयोगकर्ता बनाएँ या खोजें

नई प्रोफ़ाइल के लिए POST /v3/users/create/ कॉल करें, या किसी मौजूदा प्रोफ़ाइल के लिए GET /v3/users/{vendor_data}/ कॉल करें।
2

didit_internal_id सहेजें

उपयोगकर्ता रिस्पॉन्स में didit_internal_id शामिल होता है। अपने डेटाबेस में vendor_data का उपयोग जारी रखें; didit_internal_id का उपयोग केवल प्रोफ़ाइल अटैचमेंट endpoint के लिए करें।
3

चेहरा अपलोड करें

image फ़ील्ड में कच्ची base64 छवि भेजें। सहेजने से पहले बैकएंड छवि डिकोडिंग, छवि आकार और चेहरे का पता लगाने की जाँच करता है।

उदाहरण

अनुरोध का मुख्य भाग

रिस्पॉन्स

सत्यापन और सीमाएँ

  • हर उपयोगकर्ता के लिए मैन्युअल रूप से अधिकतम 5 चेहरे अपलोड किए जा सकते हैं।
  • डिकोड की गई छवि का अधिकतम आकार 2 MB है।
  • छवि मान्य base64 होनी चाहिए और उसे छवि के रूप में डिकोड किया जा सकना चाहिए।
  • छवि में पहचाना जा सकने वाला चेहरा होना चाहिए। जब संभव हो, सामने से देखे गए, अच्छी रोशनी वाले चेहरे का क्रॉप उपयोग करें।
  • अपलोड किया गया चेहरा भविष्य की डुप्लिकेट पहचान और चेहरा खोज के लिए इंडेक्स किया जाता है।
  • अपलोड किया गया चेहरा स्वचालित रूप से ब्लॉकलिस्ट में नहीं जोड़ा जाता।

अपलोड किए गए चेहरों की सूची बनाएँ या हटाएँ

प्रोफ़ाइल में मौजूद चेहरों की सूची देखें:
प्रोफ़ाइल से एक चेहरा हटाएँ:

अनुमतियाँ

उसी एप्लिकेशन की API कुंजी का उपयोग करें। कुंजी ऐसे ऐप की होनी चाहिए जिसे लक्ष्य उपयोगकर्ता प्रोफ़ाइल प्रबंधित करने की अनुमति हो।

विफलता के प्रकार

  • 400 – अमान्य base64, अमान्य छवि, कोई पता लगाने योग्य चेहरा नहीं, 2 MB से बड़ी छवि, या उपयोगकर्ता के पास पहले से 5 अपलोड किए गए चेहरे हैं।
  • 401 – क्रेडेंशियल गायब हैं या अमान्य हैं।
  • 403 – API कुंजी मान्य है, लेकिन इस उपयोगकर्ता प्रोफ़ाइल को प्रबंधित करने की अनुमति नहीं है।
  • 404 – एप्लिकेशन में उस didit_internal_id के लिए कोई उपयोगकर्ता मौजूद नहीं है।
  • 429 – रेट लिमिट लागू है; Retry-After का उपयोग करके प्रतीक्षा करें और फिर पुनः प्रयास करें।

संबंधित

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

पथ पैरामीटर

organization_id
string<uuid>
आवश्यक

संगठन UUID जिसके स्वामित्व में एप्लिकेशन है।

application_id
string<uuid>
आवश्यक

एप्लिकेशन UUID जिसके पास उपयोगकर्ता प्रोफ़ाइल का स्वामित्व है।

didit_internal_id
string<uuid>
आवश्यक

Didit का आंतरिक उपयोगकर्ता UUID, जिसे GET /v3/users/{vendor_data}/ और POST /v3/users/create/ द्वारा didit_internal_id के रूप में लौटाया जाता है।

बॉडी

application/json
image
string<byte>
आवश्यक

रॉ base64-एन्कोडेड JPG या PNG चेहरे की छवि। data:image/...;base64, प्रीफ़िक्स शामिल न करें। अधिकतम डिकोड किया गया आकार: 2 MB।

comment
string
डिफ़ॉल्ट:""

अपलोड किए गए चेहरे के लिए वैकल्पिक ऑपरेटर-दृश्यमान नोट।

प्रतिक्रिया

चेहरा अपलोड किया गया और उपयोगकर्ता प्रोफ़ाइल से संलग्न किया गया।

uuid
string<uuid>
आवश्यक

अपलोड किए गए उपयोगकर्ता फ़ेस रिकॉर्ड का UUID।

image_url
string<uri> | null
आवश्यक

अपलोड की गई चेहरे की छवि के लिए हस्ताक्षरित URL।

comment
string | null
आवश्यक

चेहरा अपलोड करते समय दी गई टिप्पणी।

uploaded_by
string | null
आवश्यक

उपलब्ध होने पर अपलोडर का ईमेल या कर्ता पहचानकर्ता।

created_at
string<date-time>
आवश्यक

अपलोड टाइमस्टैम्प।

अंतिम संशोधन 7 नवंबर 2026