NueForm

Files API

अपने फॉर्म्स से जुड़े फ़ाइल अपलोड की सूची देखें और प्रबंधित करें।

Files API आपको अपने अकाउंट से जुड़े फ़ाइल अपलोड की सूची देखने देता है। फ़ाइलें तब बनाई जाती हैं जब उत्तरदाता फ़ाइल अपलोड प्रश्न सबमिट करते हैं या जब आप फॉर्म बिल्डर में मीडिया (इमेज, वीडियो) अपलोड करते हैं।

सभी response bodies snake_case फ़ील्ड नामों का उपयोग करते हैं।

Endpoints
GET/api/v1/files

फ़ाइलों की सूची

GET/api/v1/files

authenticated उपयोगकर्ता के लिए फ़ाइल अपलोड की paginated सूची लौटाता है। इसमें बिल्डर मीडिया अपलोड (उपयोगकर्ता के स्वामित्व वाले) और उत्तरदाता फ़ाइल अपलोड (उपयोगकर्ता के फॉर्म्स से जुड़े) दोनों शामिल हैं।

Query Parameters

pageinteger

पेज नंबर (डिफ़ॉल्ट: 1)

per_pageinteger

प्रति पेज परिणाम (डिफ़ॉल्ट: 50)

Response Fields

idstring

यूनिक फ़ाइल अपलोड ID

blob_urlstring

फ़ाइल एक्सेस करने के लिए सार्वजनिक URL

original_namestring

उपयोगकर्ता द्वारा अपलोड किया गया मूल फ़ाइलनाम

uuid_namestring

blob storage में उपयोग किया गया UUID-आधारित फ़ाइलनाम

sizeinteger

बाइट्स में फ़ाइल का आकार

content_typestring

फ़ाइल का MIME प्रकार (जैसे, "image/png", "application/pdf")

form_idstring or null

वह फॉर्म जिससे यह फ़ाइल जुड़ी है (उत्तरदाता अपलोड के लिए)

user_idstring or null

वह उपयोगकर्ता जिसने यह फ़ाइल अपलोड की (बिल्डर मीडिया के लिए)। उत्तरदाता अपलोड के लिए null।

created_atstring

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

फ़ाइल प्रकार

फ़ाइलें user_id और form_id फ़ील्ड के आधार पर दो श्रेणियों में आती हैं:

श्रेणीuser_idform_idविवरण
बिल्डर मीडियासेटnull या सेटफॉर्म बिल्डर में आपके द्वारा अपलोड की गई इमेज, वीडियो, या दस्तावेज़ (जैसे, प्रश्न इमेज, लोगो)
उत्तरदाता अपलोडnullसेटफ़ाइल अपलोड प्रश्नों के माध्यम से उत्तरदाताओं द्वारा सबमिट की गई फ़ाइलें

स्टोरेज सीमाएं

फ़ाइल स्टोरेज प्रति अकाउंट ट्रैक किया जाता है। आप User API के माध्यम से अपने वर्तमान उपयोग की जांच कर सकते हैं। स्टोरेज सीमाएं प्लान टियर के अनुसार भिन्न होती हैं। जब कोई फॉर्म डिलीट किया जाता है, तो संबंधित उत्तरदाता फ़ाइल अपलोड asynchronously रूप से साफ़ किए जाते हैं और स्टोरेज पुनः प्राप्त होता है।

Response

json
{
  "files": [
    {
      "id": "668a1b2c3d4e5f6a7b8c9d01",
      "blob_url": "https://abcdef.public.blob.vercel-storage.com/uploads/a1b2c3d4.pdf",
      "original_name": "project-proposal.pdf",
      "uuid_name": "a1b2c3d4.pdf",
      "size": 245760,
      "content_type": "application/pdf",
      "form_id": "665a1b2c3d4e5f6a7b8c9d0e",
      "user_id": null,
      "created_at": "2026-02-25T14:30:00.000Z"
    },
    {
      "id": "668a1b2c3d4e5f6a7b8c9d02",
      "blob_url": "https://abcdef.public.blob.vercel-storage.com/uploads/e5f6a7b8.png",
      "original_name": "hero-banner.png",
      "uuid_name": "e5f6a7b8.png",
      "size": 1048576,
      "content_type": "image/png",
      "form_id": null,
      "user_id": "665a0a1b2c3d4e5f6a7b8c9d",
      "created_at": "2026-02-20T10:15:00.000Z"
    }
  ],
  "total": 38,
  "page": 1,
  "per_page": 50
}

कोड उदाहरण

bash
curl -X GET "https://api.nueform.io/api/v1/files?page=1&per_page=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Error Responses

इस endpoint द्वारा लौटाए गए मानक error responses।

Error Codes

401Unauthorized

API key गायब या अमान्य है

500Server Error

Internal server error

Error उदाहरण

json
{
  "error": "Unauthorized"
}
अंतिम अपडेट: 6 अप्रैल 2026