REST

API टोकन के लिए API से कनेक्ट करें देखें। सार्वजनिक REST मूल URL https://reconstruct.dev/api/v1/platform है; नीचे के पथ इसके सापेक्ष हैं।

GET /capture-options से प्रकार/परिवेश खोजें; ID हार्डकोड न करें। विकल्प में view प्रकार (desktop/mobile), implementation परिवेश है। डेस्कटॉप web, web-extension, macos, windows, linux; मोबाइल web, ios, android लेता है। डेटा से पहले captured देखें। MCP में नाम platform, environment; पृष्ठ view सटीक सहेजी डिवाइस प्रोफ़ाइल कुंजी है। MCP चयन देखें।

हर अनुरोध में Authorization: Bearer <token> भेजें। कैटलॉग endpoint:

विधि और पथ	उद्देश्य
GET /catalogs?pageSize=10&pageToken=...	कैटलॉग सूची; pageSize, pageToken वैकल्पिक।
GET /capture-options	समर्थित प्रकार ID, लेबल, परिवेश विकल्प, डिफ़ॉल्ट और अनुरोध requestPlatforms; प्रमाणीकरण/मापन नहीं, कैप्चर सामग्री नहीं।
GET /catalogs/{catalogId}?version=...	प्रकाशित कैटलॉग के स्क्रीन, प्लेटफ़ॉर्म, भाषाएँ, संस्करण पढ़ें।
GET /catalogs/{catalogId}/insights?locale=en&view=desktop&implementation=web	प्रकाशित संस्करण की तकनीक, रेंडरिंग, फ़ॉन्ट परिवार, टेक्स्ट शैली, मीडिया और रंग थीम पढ़ें।

JSON फ़ील्ड camelCase हैं। GET /catalogs से catalogs और अधिक परिणाम पर nextPageToken मिलता है। अगली क्वेरी में उसे pageToken दें। विवरण में catalogId, name, kind, description हैं।

locale, view, implementation वैकल्पिक हैं। view में desktop/mobile; implementation में web, web-extension, windows, macos, linux, ios, android लें। विवरण platforms[] में संयोजन, स्क्रीन अपना implementation देती हैं। तकनीक, टाइपोग्राफ़ी, मीडिया उसी संयोजन/भाषा के हैं। प्रति-view पहचान न हो तो technologyInventory: true संस्करण-सूची बताता है। नकली iPhone पर वेब mobile + web रहता है। पुराने कैप्चर में पृष्ठ विवरण न हों तो संस्करण फ़ॉन्ट/संपत्ति सूची और pageCount: 0 लौटते हैं। लिंक मूल स्रोत रखते हैं; सहेजे संसाधन नीचे की फ़ाइल विधि से पढ़ें।

कैटलॉग फ़िल्टर और संस्करण

ListCatalogs में query, sort (newest, name-asc, name-desc, screens, versions), screens (with/without), versions (single/multiple) और दोहराए platforms, technologies, renderings, categories, languages हैं। प्लेटफ़ॉर्म ID view/implementation जोड़ता है, जैसे desktop:web। filters के ID लें; एक फ़िल्टर के विकल्प वैकल्पिक, अलग फ़िल्टर संयुक्त हैं। nextPageToken के दौरान फ़िल्टर/क्रम न बदलें।

GetCatalog, GetCatalogInsights, GetCatalogFile वैकल्पिक version लेते हैं। खाली पर नवीनतम प्रकाशित कैप्चर। विवरण चयनित version, सभी प्रकाशित versions[] देता है; latestVersion, latestCapturedAt नवीनतम बताते हैं। आगे insight/फ़ाइल में चयनित संस्करण दें। ड्राफ़्ट/अज्ञात संस्करण 404 देते हैं।

Insight में section: tech stack, typography, colors, themes, assets लें, सभी के लिए छोड़ें। colorThemes[] नामित पैलेट हैं। platforms[].captured उपलब्धता, detectedLocales[] खोजी भाषाएँ, locales[] कैप्चर भाषाएँ हैं।

कंपोनेंट माप

componentSizing[] अर्थपूर्ण प्रकार से माप समूहित करता है। Components टैब में खोलकर स्क्रीनशॉट, आकार, padding, कोना, बॉर्डर, छाया, अवस्थाएँ देखें। सामान्य कंटेनर बाहर हैं।

dimensionContexts[] स्वामित्व जोड़ता है: प्रकार, CSS गुण, मूल मान/शॉर्टहैंड, कुल और तीन तक नमूने। नमूने पृष्ठ, view, सापेक्ष पथ, स्रोत ID/tag/लेबल, ज्ञात parent, तीन प्रत्यक्ष children देते हैं (childCount कुल)। ये उसी पृष्ठ/view/संस्करण के मूल ID हैं, बदले MCP layer ID नहीं। नमूने की view सटीक कुंजी, जैसे laptop, फ़िल्टर view desktop/mobile है। अनुपस्थित ID -1। संख्या केवल कैप्चर तत्वों की है; संख्या/नमूने पूरा वेबसाइट कवरेज नहीं कहते।

माप हर कंपोनेंट विवरण में हैं। Padding भीतर, margin बाहर है, आवश्यक नहीं पड़ोसी दूरी। Gap कंटेनर का है; children उदाहरण हैं, मापे पड़ोसी जोड़े नहीं। Sizing कंपोनेंट का अपना है। मूल इकाई/शॉर्टहैंड रखें। MCP get_spacing और get_sizing एक पृष्ठ/view का पृष्ठांकित संदर्भ/सार देते हैं।

Fonts टैब मूल फ़ॉन्ट ZIP देता है; आकार/भाषा उपयोग JSON textStyles[], fonts[].locales से बनते हैं। ये क्लाइंट फ़ाइलें हैं, अतिरिक्त @export नहीं। detectedLocales भाषाएँ उनके स्क्रीनशॉट की गारंटी नहीं।

सहेजी फ़ाइलें और निर्यात

GET /catalogs/{catalogId}/files/{path} JSON BinaryFileResponse देता है: data base64, contentType डिकोड बाइट का प्रकार। पथ screens[] से हैं (imagePath, fullPagePath, sectionPaths[], videoPath, interactionVideoPath)। captureLimited अधूरापन है।

मार्ग मूल संग्रह के लिए @asset/{hash}, @font/{hash}, @model/{hash} लेता है; hash UTF-8 मूल URL/data URL का SHA-256, lowercase hex है। @export/assets, @export/fonts, @export/colors, @export/screenshots, @export/components, @export/languages, @export/technologies, @export/spacing-sizing ZIP देते हैं। spacing/sizing में spacing-sizing.json है: चयनित संस्करण, पृष्ठ संख्या, dimensions, componentSizing, dimensionContexts। चयनित कैप्चर फ़ाइल/निर्यात के लिए version लें। साधारण कैप्चर JSON उपलब्ध नहीं।

कॉल करने वाले के ऑपरेशन

विधि और पथ	उद्देश्य
POST /requests	requestType: PRODUCT_REQUEST_TYPE_ADD के साथ url, subject, या requestType: PRODUCT_REQUEST_TYPE_UPDATE के साथ catalogId भेजें।
GET /requests, GET /requests/{requestId}	अपने अनुरोध पृष्ठांकित करके निर्णय, सुरक्षा, कैप्चर प्रगति देखें।
GET /me/appearance, PUT /me/appearance	उपनाम पढ़ें/बदलें।
GET /me/avatar, PUT /me/avatar, DELETE /me/avatar	अवतार पढ़ें, base64 data अपलोड करें या हटाएँ।
GET /tokens, POST /tokens, DELETE /tokens/{id}	व्यक्तिगत टोकन प्रबंधित करें; बनाना name, scopes (api, mcp), expiresInDays (1–365) लेता है। सीक्रेट एक बार मिलता है।
GET /me/profile, PUT /me/profile	खाता प्रोफ़ाइल (profile) पढ़ें/बदलें।
GET /me/credentials, GET /me/sessions, DELETE /me/sessions/{id}	क्रेडेंशियल/सत्र देखें और सत्र बंद करें।

खाता, रूप, अवतार, टोकन प्रबंधन के लिए साइन इन उपयोगकर्ता सत्र टोकन चाहिए; व्यक्तिगत API टोकन अनुमति नहीं देते। कैटलॉग/अनुरोध api स्कोप लेते हैं। WatchCatalogs, WatchRequests gRPC/gRPC-Web स्ट्रीम हैं, REST पथ नहीं।

उदाहरण

• curl
• Python
• C#
• TypeScript
• Go
• Rust
• Java
• C++

समान मूल URL के नीचे POST /requests, GET /requests, GET /requests/{request_id} लें। requestType: PRODUCT_REQUEST_TYPE_ADD को url, subject चाहिए; catalogId वैकल्पिक। PRODUCT_REQUEST_TYPE_UPDATE को मौजूद catalogId दें; सर्वर नाम/स्रोत खोजता है। अनुरोध सहेजे जाते हैं, केवल मालिक देखता है। कैप्चर से पहले समीक्षा में स्वीकार/कारण सहित अस्वीकार होते हैं। ज्ञात असुरक्षित साइट स्वतः अस्वीकृत। REST/gRPC समान ऑपरेशन देते हैं।

मानकीकृत इंटरफ़ेस डेटा

Scene डेटा प्रारूप में तटस्थ इंटरफ़ेस आर्टिफ़ैक्ट, अवस्थाएँ, संसाधन, साक्ष्य हैं। वर्तमान मानकीकृत निर्यात MCP get_interface_scene से मिलता है; कैटलॉग API में अलग Scene ऑपरेशन नहीं।