{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
Referencia de API
API de eventos de servidor — POST /server-events
Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
{
"error": true,
"message": "Too many requests. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED"
}
Usa este endpoint para informar de una sola conversión del backend. Para enviar varios eventos en una misma petición, usa POST /server-events/batch.Genera la X-API-Key que necesitas desde tu sitio de seguimiento: Análisis → Seguimiento de conversiones → Configurar el seguimiento de conversiones y luego Configuración de seguimiento → Rastrear vía API en tu sitio.Consulta Enviar eventos de servidor para ver ejemplos de código en Node.js, Python, PHP y cURL.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Scanova API Documentation","colors":{"primary":"#6938ef","light":"#6938ef","dark":"#6938ef"},"logo":{"light":"https://mintcdn.com/scanova-api/89jUfOeAiT0p2JGx/images/PrimaryColor-Full.svg?fit=max\u0026auto=format\u0026n=89jUfOeAiT0p2JGx\u0026q=85\u0026s=edc08604efcf06d6dd5d00e9e2c50f20","dark":"https://mintcdn.com/scanova-api/89jUfOeAiT0p2JGx/images/WhiteColor-Full2.svg?fit=max\u0026auto=format\u0026n=89jUfOeAiT0p2JGx\u0026q=85\u0026s=84e81cd9168db3d3ca3949b427e2d6c6"},"favicon":{"light":"https://mintcdn.com/scanova-api/aXUnnYg-8s3nt2o_/images/favicon-64x64.png?fit=max\u0026auto=format\u0026n=aXUnnYg-8s3nt2o_\u0026q=85\u0026s=b59720ad14aa6f2f474ea4380bf15d23","dark":"https://mintcdn.com/scanova-api/aXUnnYg-8s3nt2o_/images/favicon-64x64.png?fit=max\u0026auto=format\u0026n=aXUnnYg-8s3nt2o_\u0026q=85\u0026s=b59720ad14aa6f2f474ea4380bf15d23"},"background":{"color":{"dark":"#05060f"}},"navbar":{"links":[{"href":"https://scanova.io/contact-support/","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.scanova.io"}},"footer":{"socials":{"website":"https://scanova.io","youtube":"https://www.youtube.com/channel/UCHSrteaenPuxL0WjLFmhaEA/featured","x":"https://twitter.com/scanovatech","linkedin":"https://www.linkedin.com/products/scanova-qr-code-generator"}},"integrations":{"ga4":{"measurementId":"G-GWMY0DDJWB"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"languages":[{"language":"en","default":true,"href":"getting-started/what-is-scanova"},{"language":"de","href":"de/getting-started/what-is-scanova"},{"language":"es","href":"es/getting-started/what-is-scanova"},{"language":"fr","href":"fr/getting-started/what-is-scanova"},{"language":"zh","href":"zh/getting-started/what-is-scanova"},{"language":"ar","href":"ar/getting-started/what-is-scanova"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"scanova-api","hasAudioNarration":false,"actualSubdomain":"scanova-api","customDomains":["docs.scanova.io"],"gitSource":{"type":"github","owner":"trycon","repo":"qcg-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeae5422d1fe1dfc0da7326","collectionId":"be1f7f57-9002-4484-8744-623fd9e88bd2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeae5422d1fe1dfc0da7326"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6aeae5422d1fe1dfc0da7326","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"en","tag":"API Reference","count":271},{"language":"de","tag":"API-Referenz","count":197},{"language":"es","tag":"Referencia de API","count":197},{"language":"fr","tag":"Référence API","count":197},{"language":"ar","tag":"مرجع واجهة البرمجة","count":189},{"language":"zh","tag":"API 参考","count":189},{"language":"en","tag":"Guides","count":115},{"language":"ar","tag":"الأدلة","count":96},{"language":"de","tag":"Anleitungen","count":96},{"language":"es","tag":"Guías","count":96},{"language":"fr","tag":"Guides","count":96},{"language":"zh","tag":"指南","count":93},{"language":"default","tag":"Guides (Legacy)","count":61},{"language":"en","tag":"QR Codes","count":49},{"language":"default","tag":"API reference (Legacy)","count":46},{"language":"en","tag":"Integrations","count":30},{"language":"default","tag":"Category Components","count":30},{"language":"en","tag":"Leads \u0026 Forms","count":28},{"language":"ar","tag":"العملاء المحتملون والنماذج","count":28},{"language":"default","tag":"Categories","count":28},{"language":"de","tag":"Leads \u0026 Formulare","count":28},{"language":"es","tag":"Clientes potenciales y formularios","count":28},{"language":"fr","tag":"Prospects et formulaires","count":28},{"language":"zh","tag":"潜在客户与表单","count":28},{"language":"ar","tag":"Conversion Tracking","count":27},{"language":"default","tag":"Conversion Tracking","count":27},{"language":"de","tag":"Conversion Tracking","count":27},{"language":"es","tag":"Conversion Tracking","count":27},{"language":"fr","tag":"Conversion Tracking","count":27},{"language":"en","tag":"QR Assets","count":26},{"language":"ar","tag":"أصول QR","count":26},{"language":"de","tag":"QR-Assets","count":26},{"language":"es","tag":"Recursos de QR","count":26},{"language":"fr","tag":"Ressources QR","count":26},{"language":"zh","tag":"QR 资源","count":26},{"language":"en","tag":"QR Codes — Create","count":25},{"language":"ar","tag":"رموز QR — إنشاء","count":23},{"language":"de","tag":"QR-Codes — Erstellen","count":23},{"language":"es","tag":"Códigos QR — Crear","count":23},{"language":"fr","tag":"Codes QR — Créer","count":23},{"language":"zh","tag":"二维码 — 创建","count":23},{"language":"en","tag":"QR Codes — Manage","count":18},{"language":"en","tag":"Analytics \u0026 Plans","count":17},{"language":"ar","tag":"التحليلات والخطط","count":17},{"language":"de","tag":"Analysen \u0026 Tarife","count":17},{"language":"es","tag":"Analítica y planes","count":17},{"language":"fr","tag":"Analytique et forfaits","count":17},{"language":"zh","tag":"分析与套餐","count":17},{"language":"en","tag":"Bulk Operations","count":16},{"language":"ar","tag":"العمليات بالجملة","count":16},{"language":"de","tag":"Massenvorgänge","count":16},{"language":"es","tag":"Operaciones en masa","count":16},{"language":"fr","tag":"Opérations en masse","count":16},{"language":"zh","tag":"批量操作","count":16},{"language":"ar","tag":"النطاقات المخصصة","count":14},{"language":"ar","tag":"المستخدمون المشتركون والأدوار","count":14},{"language":"de","tag":"Benutzerdefinierte Domains","count":14},{"language":"de","tag":"Geteilte Nutzer \u0026 Rollen","count":14},{"language":"es","tag":"Dominios personalizados","count":14},{"language":"es","tag":"Usuarios compartidos y roles","count":14},{"language":"fr","tag":"Domaines personnalisés","count":14},{"language":"fr","tag":"Utilisateurs partagés et rôles","count":14},{"language":"zh","tag":"自定义域名","count":14},{"language":"zh","tag":"共享用户与角色","count":14},{"language":"zh","tag":"主题与页面模板","count":14},{"language":"default","tag":"QR Code Management","count":9},{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Browser SDK","count":7},{"language":"default","tag":"Folder Management","count":6},{"language":"default","tag":"Form Management","count":6}],"searchSettings":{"maxResults":10,"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"es/conversion-tracking/api/events-collect","slug":"/es/conversion-tracking/api/events-collect","pageMetadata":{"title":"API de eventos de servidor — POST /server-events","openapi":"POST /server-events","description":"Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.","href":"/es/conversion-tracking/api/events-collect"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Usa este endpoint para informar de una sola conversión del backend. Para enviar varios eventos en una misma petición, usa `,_jsx(_components.a,{href:`/es/conversion-tracking/api/events-batch`,children:`POST /server-events/batch`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Genera la `,_jsx(_components.code,{children:`X-API-Key`}),` que necesitas desde tu sitio de seguimiento: `,_jsx(_components.strong,{children:`Análisis → Seguimiento de conversiones → Configurar el seguimiento de conversiones`}),` y luego `,_jsx(_components.strong,{children:`Configuración de seguimiento → Rastrear vía API`}),` en tu sitio.`]}),`\n`,_jsxs(_components.p,{children:[`Consulta `,_jsx(_components.a,{href:`/es/conversion-tracking/server/send-events`,children:`Enviar eventos de servidor`}),` para ver ejemplos de código en Node.js, Python, PHP y cURL.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"API de eventos de servidor — POST /server-events","openapi":"POST /server-events","description":"Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.","href":"/es/conversion-tracking/api/events-collect"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Server Events"],"summary":"Send server-side event","description":"Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.","operationId":"serverEvent","security":["c71a1371-e068-4c50-8e7c-4f19fe77ef58"],"requestBody":"029c8c63-9a6b-42b4-9e8b-467bfc3c8230","responses":{"200":"62b642a5-33cb-48e6-b8d1-3aff0a973488","400":"e588c2df-240c-4870-a1b5-bccc5f0eaf66","401":"d96a043a-485d-43b0-b6c6-1b28d7e15059","403":"bd5d7919-06c3-4f99-8fd6-fcff59334ae0","422":"4c6a8342-a299-4dc2-b828-5cb682075269","429":"00c7a16f-2b9c-41fe-9c6d-45a6230dfc31"},"method":"post","type":"path","servers":["02a82243-44ee-4c64-8f37-21d34489c5e5"],"path":"/server-events","baseUrlOptions":["https://track.scanova.io"],"title":"Send server-side event","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["site_id","event_name"],"properties":{"site_id":{"type":"string","minLength":1,"maxLength":64,"description":"Tracking site ID","isRequired":true,"uniqueKey":"site_id","typeLabel":"string"},"event_name":{"type":"string","minLength":1,"maxLength":64,"description":"Event name (normalized to lowercase/underscore by API)","isRequired":true,"uniqueKey":"event_name","typeLabel":"string"},"scan_session_id":{"type":"string","format":"uuid","description":"QR scan session id from scnv redirect","uniqueKey":"scan_session_id","typeLabel":"string\u003cuuid>"},"event_id":{"type":"string","format":"uuid","description":"Unique event ID for deduplication","uniqueKey":"event_id","typeLabel":"string\u003cuuid>"},"event_time":{"type":"string","format":"date-time","description":"Event occurrence time","uniqueKey":"event_time","typeLabel":"string\u003cdate-time>"},"user_identifiers":{"type":"object","properties":{"email_hash":{"type":"string","minLength":64,"maxLength":64,"description":"SHA-256 hash of normalized lowercase email","uniqueKey":"user_identifiers.email_hash","typeLabel":"string"},"phone_hash":{"type":"string","minLength":64,"maxLength":64,"description":"SHA-256 hash of normalized E.164 phone number","uniqueKey":"user_identifiers.phone_hash","typeLabel":"string"},"external_id":{"type":"string","maxLength":128,"description":"Your internal user ID","uniqueKey":"user_identifiers.external_id","typeLabel":"string"}},"uniqueKey":"user_identifiers","typeLabel":"object"},"conversion_value":{"type":"object","required":["amount"],"properties":{"amount":{"type":"number","minimum":0,"description":"Conversion amount","isRequired":true,"uniqueKey":"conversion_value.amount","typeLabel":"number"},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD","description":"ISO 4217 currency code","uniqueKey":"conversion_value.currency","typeLabel":"string"}},"uniqueKey":"conversion_value","typeLabel":"object"},"properties":{"type":"object","additionalProperties":true,"description":"Custom properties. Max serialized size 10KB. Do not include raw email addresses.","uniqueKey":"properties","typeLabel":"object"},"consent":{"oneOf":[{"type":"string","enum":["granted","denied","pending"],"description":"Consent signal propagated from browser-side tracking","uniqueKey":"consent.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["granted","denied","pending"],"description":"Consent signal propagated from browser-side tracking","uniqueKey":"consent.oneOf.1","typeLabel":"null"}],"uniqueKey":"consent","typeLabel":"enum\u003cstring> | null"}},"example":{"site_id":"site_abc123","event_name":"purchase","scan_session_id":"550e8400-e29b-41d4-a716-446655440000","conversion_value":{"amount":99.99,"currency":"USD"},"user_identifiers":{"email_hash":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855","external_id":"user_12345"},"properties":{"order_id":"order_789","product_ids":["prod_1","prod_2"]}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"site_id":"site_abc123","event_name":"purchase","scan_session_id":"550e8400-e29b-41d4-a716-446655440000","conversion_value":{"amount":99.99,"currency":"USD"},"user_identifiers":{"email_hash":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855","external_id":"user_12345"},"properties":{"order_id":"order_789","product_ids":["prod_1","prod_2"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"62b642a5-33cb-48e6-b8d1-3aff0a973488":{"description":"Event accepted","content":{"application/json":{"schema":{"type":"object","required":["success","event_id","message"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"event_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"event_id","typeLabel":"string\u003cuuid>"},"message":{"type":"string","example":"Event received","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"event_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","message":"Event received"}}},"exampleType":"generated"}},"exampleType":"generated"},"e588c2df-240c-4870-a1b5-bccc5f0eaf66":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"d96a043a-485d-43b0-b6c6-1b28d7e15059":{"description":"Missing API key","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"bd5d7919-06c3-4f99-8fd6-fcff59334ae0":{"description":"Invalid API key or unauthorized site_id","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"4c6a8342-a299-4dc2-b828-5cb682075269":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"00c7a16f-2b9c-41fe-9c6d-45a6230dfc31":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","example":"Too many requests. Retry after 60 seconds.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"RATE_LIMIT_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"Too many requests. Retry after 60 seconds.","code":"RATE_LIMIT_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c71a1371-e068-4c50-8e7c-4f19fe77ef58":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Site-scoped server API key generated from Dashboard > Analytics > Conversion Tracking > Script/API > API tab","scopes":[]}}},"servers":{"02a82243-44ee-4c64-8f37-21d34489c5e5":{"url":"https://track.scanova.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Site-scoped server API key generated from Dashboard > Analytics > Conversion Tracking > Script/API > API tab","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"Site-scoped server API key generated from Dashboard > Analytics > Conversion Tracking > Script/API > API tab","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"conversion-tracking/openapi/conversion-tracking.json"},"subdomain":"scanova-api","siteName":"Scanova API Documentation","title":"API de eventos de servidor — POST /server-events - Scanova API Documentation","navMaps":{"firstHrefInVersion":{"v2":{"href":"/es/conversion-tracking/api/events-collect","matchLevel":0},"v1":{"href":"/v1/index","matchLevel":4}},"firstHrefInLanguage":{"en":{"href":"/conversion-tracking/api/events-collect","matchLevel":1},"de":{"href":"/de/conversion-tracking/api/events-collect","matchLevel":1},"es":{"href":"/es/conversion-tracking/api/events-collect","matchLevel":0},"fr":{"href":"/fr/conversion-tracking/api/events-collect","matchLevel":1},"zh":{"href":"/conversion-tracking/api/events-collect","matchLevel":1},"ar":{"href":"/ar/conversion-tracking/api/events-collect","matchLevel":1}}},"lastModified":"2026-09-17T15:36:06.082Z","originalFileLocation":"es/conversion-tracking/api/events-collect.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Scanova API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"API de eventos de servidor — POST /server-events - Scanova API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Scanova API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.scanova.io/es/conversion-tracking/api/events-collect\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://scanova-api.mintlify.app/_mintlify/api/og/v2?division=Referencia+de+API\u0026amp;title=API+de+eventos+de+servidor+%E2%80%94+POST+%2Fserver-events\u0026amp;description=Env%C3%ADa+un+%C3%BAnico+evento+de+conversi%C3%B3n+de+servidor+autenticado+%28compra%2C+registro%2C+lead+o+cualquier+acci%C3%B3n+del+backend%29+atribuido+a+un+escaneo+de+c%C3%B3digo+QR.\u0026amp;theme=f9ed38a6e1c8b99666344abf\u0026amp;signature=840056b734ee35921435998a003b2d78732c17b91f12ef130af91fde6f767dbc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"API de eventos de servidor — POST /server-events - Scanova API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://scanova-api.mintlify.app/_mintlify/api/og/v2?division=Referencia+de+API\u0026amp;title=API+de+eventos+de+servidor+%E2%80%94+POST+%2Fserver-events\u0026amp;description=Env%C3%ADa+un+%C3%BAnico+evento+de+conversi%C3%B3n+de+servidor+autenticado+%28compra%2C+registro%2C+lead+o+cualquier+acci%C3%B3n+del+backend%29+atribuido+a+un+escaneo+de+c%C3%B3digo+QR.\u0026amp;theme=f9ed38a6e1c8b99666344abf\u0026amp;signature=840056b734ee35921435998a003b2d78732c17b91f12ef130af91fde6f767dbc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/scanova-api/kNDlh2zn25UXP5WX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Scanova API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6938ef\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.scanova.io/es/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/conversion-tracking/api/events-collect.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.scanova.io/es/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.scanova.io/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.scanova.io/de/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.scanova.io/fr/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.scanova.io/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.scanova.io/ar/conversion-tracking/api/events-collect\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.scanova.io/conversion-tracking/api/events-collect\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.scanova.io/#organization\",\"name\":\"Scanova API Documentation\",\"url\":\"https://docs.scanova.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/scanova-api/89jUfOeAiT0p2JGx/images/PrimaryColor-Full.svg?fit=max\u0026auto=format\u0026n=89jUfOeAiT0p2JGx\u0026q=85\u0026s=edc08604efcf06d6dd5d00e9e2c50f20\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.scanova.io#website\",\"name\":\"Scanova API Documentation\",\"url\":\"https://docs.scanova.io\",\"publisher\":{\"@id\":\"https://docs.scanova.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.scanova.io/es/conversion-tracking/api/events-collect#webpage\",\"url\":\"https://docs.scanova.io/es/conversion-tracking/api/events-collect\",\"name\":\"API de eventos de servidor — POST /server-events\",\"description\":\"Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.\",\"dateModified\":\"2026-09-17T15:36:06.082Z\",\"isPartOf\":{\"@id\":\"https://docs.scanova.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.scanova.io/es/conversion-tracking/api/events-collect#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.scanova.io/es/conversion-tracking/api/events-collect#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Referencia de API\",\"item\":\"https://docs.scanova.io/es/conversion-tracking/api/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API de eventos de servidor — POST /server-events\",\"item\":\"https://docs.scanova.io/es/conversion-tracking/api/events-collect\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.scanova.io/es/conversion-tracking/api/events-collect#apireference\",\"headline\":\"API de eventos de servidor — POST /server-events\",\"name\":\"API de eventos de servidor — POST /server-events\",\"description\":\"Envía un único evento de conversión de servidor autenticado (compra, registro, lead o cualquier acción del backend) atribuido a un escaneo de código QR.\",\"url\":\"https://docs.scanova.io/es/conversion-tracking/api/events-collect\",\"mainEntityOfPage\":{\"@id\":\"https://docs.scanova.io/es/conversion-tracking/api/events-collect#webpage\"},\"dateModified\":\"2026-09-17T15:36:06.082Z\",\"publisher\":{\"@id\":\"https://docs.scanova.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.scanova.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Scanova API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Scanova API Documentation","nav":{"global":{},"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/conversion-tracking/api/events-collect"}]},{"language":"de","pages":[{"title":"de","href":"/de/conversion-tracking/api/events-collect"}]},{"language":"es","versions":[{"version":"v2","default":true,"tag":"Latest","tabs":[{"tab":"Guías","pages":[{"title":"Guías","href":"/es/getting-started/what-is-scanova"}]},{"tab":"Referencia de API","pages":[{"title":"Referencia de API","href":"/es/api-reference/getting-started/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/es/mcp/overview"}]},{"tab":"Conversion Tracking","groups":[{"group":"Visión general","pages":[{"title":"¿Qué es el seguimiento de conversiones?","href":"/es/conversion-tracking/introduction"},{"title":"Cómo funciona el seguimiento de conversiones","href":"/es/conversion-tracking/how-it-works"},{"title":"Inicio rápido: en marcha en 5 pasos","href":"/es/conversion-tracking/setup-guide"},{"title":"Referencia del modelo de eventos","href":"/es/conversion-tracking/event-model"}]},{"group":"SDK del navegador","pages":[{"title":"Resumen del SDK de navegador","href":"/es/conversion-tracking/browser/overview"},{"title":"Instalar el SDK de navegador","href":"/es/conversion-tracking/browser/install"},{"title":"Referencia de configuración del SDK","href":"/es/conversion-tracking/browser/sdk-configuration"},{"title":"Eventos registrados automáticamente","href":"/es/conversion-tracking/browser/auto-tracking"},{"title":"Eventos personalizados","href":"/es/conversion-tracking/browser/custom-events"},{"title":"Configuración para SPA y frameworks","href":"/es/conversion-tracking/browser/spa-frameworks"},{"title":"Verificar y depurar el SDK de navegador","href":"/es/conversion-tracking/browser/verify"}]},{"group":"En el servidor","pages":[{"title":"Eventos de servidor","href":"/es/conversion-tracking/server/overview"},{"title":"Generar una clave de API","href":"/es/conversion-tracking/server/generate-api-key-dashboard"},{"title":"Enviar eventos de servidor","href":"/es/conversion-tracking/server/send-events"},{"title":"Idempotencia y reintentos","href":"/es/conversion-tracking/server/idempotency-retries"},{"title":"Verificar y depurar eventos de servidor","href":"/es/conversion-tracking/server/verify"}]},{"group":"Referencia de API","pages":[{"title":"Autenticación de la API","href":"/es/conversion-tracking/api/authentication"},{"title":"API de eventos del navegador — POST /ct","description":"Referencia del endpoint de recogida de eventos del navegador, el que usa el SDK de Scanova para enviar páginas vistas, clics y eventos propios del visitante.","href":"/es/conversion-tracking/api/browser-events"},{"title":"API de eventos de servidor — POST /server-events","openapi":"POST /server-events","href":"/es/conversion-tracking/api/events-collect"},{"title":"API de eventos de servidor por lotes — POST /server-events/batch","openapi":"POST /server-events/batch","description":"Envía hasta 100 eventos de conversión de servidor en una sola petición autenticada. Es lo recomendable para entregas en cola y backends de mucho volumen.","href":"/es/conversion-tracking/api/events-batch"},{"title":"Errores y límites de frecuencia","href":"/es/conversion-tracking/api/errors-rate-limits"},{"title":"Analítica de conversiones","openapi":"POST /analytics/ct/","href":"/es/conversion-tracking/api/ct-analytics"},{"title":"Exportar la analítica de conversiones","openapi":"POST /analytics/ct/export/","href":"/es/conversion-tracking/api/ct-export"},{"title":"Exportar eventos de conversión sin agregar","openapi":"POST /analytics/ct/raw/","href":"/es/conversion-tracking/api/ct-raw"}]},{"group":"Recursos","pages":[{"title":"Resolución de problemas","href":"/es/conversion-tracking/troubleshooting"},{"title":"Preguntas frecuentes","href":"/es/conversion-tracking/faq"},{"title":"Historial de cambios","href":"/es/conversion-tracking/changelog"}]}]}]},{"version":"v1","tag":"Legacy","pages":[{"title":"v1","href":"/v1"}]}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/conversion-tracking/api/events-collect"}]},{"language":"zh","pages":[{"title":"zh","href":"/conversion-tracking/api/events-collect"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/conversion-tracking/api/events-collect"}]}]},"basePath":"","title":"API de eventos de servidor — POST /server-events - Scanova API Documentation","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}