domande.ch — Builder di moduli e sondaggi

Endpoint standard

Quello che un agente deve leggere.

Quattro indirizzi pubblici descrivono il servizio, dalla sintesi per i modelli linguistici alla specifica OpenAPI completa.

Widget JavaScript

Un pulsante su qualsiasi sito.

Una riga di codice aggiunge un pulsante fluttuante che apre il modulo in una finestra, senza portare le persone fuori dal tuo sito. Funziona con HTML, WordPress, Webflow e React.

Parametri

ID del modulo

Testo del pulsante

Posizione

index.html

<script 
  src="https://domande.ch/widget.js" 
  data-form-id="form_demo_12345" 
  data-button-text="Invia Feedback" 
  data-position="bottom-right">
</script>

Componente React

Il modulo dentro la pagina.

Per Next.js o React il modulo viene incorporato in linea con un iframe e si adatta alla larghezza del contenitore.

DomandeFormWidget.tsx

import React from 'react';

export function DomandeFormWidget({ formId = "form_demo_12345" }: { formId?: string }) {
  return (
    <div className="w-full max-w-2xl mx-auto my-6 overflow-hidden rounded-2xl border border-slate-800 shadow-xl bg-slate-900/50">
      <iframe
        src={`https://domande.ch/f/${formId}/embed`}
        className="w-full h-[540px] border-0"
        title="domande.ch Form"
        loading="lazy"
      />
    </div>
  );
}

REST API

Crea moduli con una richiesta.

L'API v1 crea moduli a partire da una descrizione in linguaggio naturale e gestisce moduli e risposte via HTTPS. La chiave si crea nell'app, dal menu API & MCP.

crea-modulo.js

POST https://domande.ch/api/v1/forms · Authorization: Bearer dom_sk_…

// Genera un form automaticamente usando un prompt in linguaggio naturale
const response = await fetch('https://domande.ch/api/v1/forms', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dom_sk_YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'Crea un modulo di contatto per un agenzia di viaggi con preferenze sulle destinazioni',
    status: 'published'
  })
});

const data = await response.json();
console.log('Form Creato:', data.form.id);

Server MCP

Moduli dalla chat con l'agente.

Collega domande.ch a Cursor, Claude Desktop o Antigravity per creare e leggere moduli direttamente dall'assistente.

mcp_config.json

Endpoint: https://domande.ch/api/mcp

{
  "mcpServers": {
    "domande-ch": {
      "url": "https://domande.ch/api/mcp",
      "headers": {
        "Authorization": "Bearer dom_sk_YOUR_API_KEY"
      }
    }
  }
}

Prompt per agenti

Chiedi all'agente di fare l'integrazione.

Incolla questo prompt in Cursor, Windsurf o ChatGPT: l'agente legge llms.txt e prepara il codice per il tuo progetto.