Integration Nodes

type: api
method: GET
url: "https://api.openweathermap.org/data/2.5/weather"
queryParams:
  q: "Milano,IT"
  appid: "{{secrets.OPENWEATHER_KEY}}"
  units: "metric"
headers:
  Accept: "application/json"
timeout: 10000
label: "Fetch Meteo Milano"

type: api
method: POST
url: "https://your-domain.atlassian.net/rest/api/3/issue"
headers:
  Content-Type: "application/json"
auth:
  type: basic
  username: "{{secrets.JIRA_EMAIL}}"
  password: "{{secrets.JIRA_TOKEN}}"
body: |
  {
    "fields": {
      "project": { "key": "OPS" },
      "summary": "{{trigger.data.title}}",
      "description": {
        "type": "doc",
        "version": 1,
        "content": [{
          "type": "paragraph",
          "content": [{
            "type": "text",
            "text": "{{trigger.data.description}}"
          }]
        }]
      },
      "issuetype": { "name": "Bug" },
      "priority": { "name": "{{trigger.data.priority}}" }
    }
  }
label: "Crea Ticket Jira"

type: api
method: GET
url: "https://sheets.googleapis.com/v4/spreadsheets/{{SHEET_ID}}/values/A1:Z100"
auth:
  type: oauth2
  clientId: "{{secrets.GOOGLE_CLIENT_ID}}"
  clientSecret: "{{secrets.GOOGLE_CLIENT_SECRET}}"
  refreshToken: "{{secrets.GOOGLE_REFRESH_TOKEN}}"
  tokenUrl: "https://oauth2.googleapis.com/token"
  scope: "https://www.googleapis.com/auth/spreadsheets.readonly"
label: "Fetch Google Sheet"

type: workflow
n8nUrl: "https://n8n.example.com"
workflowId: "workflow_abc123"
apiKey: "{{secrets.N8N_API_KEY}}"
inputData:
  userId: "{{trigger.data.userId}}"
  email: "{{trigger.data.email}}"
  name: "{{trigger.data.name}}"
waitForCompletion: true
timeout: 60000
label: "n8n Welcome Email"

type: email
provider: smtp
smtpHost: "smtp.gmail.com"
smtpPort: 587
smtpUser: "{{secrets.SMTP_USER}}"
smtpPassword: "{{secrets.SMTP_PASS}}"
from: "reports@example.com"
to: "team@example.com"
subject: "Report giornaliero - {{formatDate now 'DD/MM/YYYY'}}"
body: |
  <h1>Report {{formatDate now 'DD/MM/YYYY'}}</h1>
  
  <h2>Metriche</h2>
  <ul>
    <li>Visite: {{transform.data.visits}}</li>
    <li>Conversioni: {{transform.data.conversions}}</li>
    <li>Revenue: €{{transform.data.revenue}}</li>
  </ul>
  
  <p>Report generato automaticamente.</p>
label: "Report Giornaliero"

type: notification
channel: slack
webhookUrl: "{{secrets.SLACK_WEBHOOK}}"
message: |
  🚨 *Incident Alert*
  
  *Servizio:* {{trigger.data.service}}
  *Severity:* {{trigger.data.severity}}
  *Messaggio:* {{trigger.data.message}}
  
  <{{trigger.data.dashboardUrl}}|Vai alla dashboard>
color: "#FF0000"
fields:
  - title: "Ambiente"
    value: "{{trigger.data.environment}}"
    short: true
  - title: "Timestamp"
    value: "{{formatDate now 'DD/MM HH:mm'}}"
    short: true
label: "Slack Alert"

type: notification
channel: discord
webhookUrl: "{{secrets.DISCORD_WEBHOOK}}"
message: "Incident Alert"
embed:
  title: "🚨 {{trigger.data.service}}"
  description: "{{trigger.data.message}}"
  color: 16711680
  fields:
    - name: "Severity"
      value: "{{trigger.data.severity}}"
      inline: true
    - name: "Time"
      value: "{{formatDate now}}"
      inline: true
label: "Discord Alert"

type: api
method: POST
url: "https://crm.example.com/webhooks/orders"
headers:
  Content-Type: "application/json"
  X-Webhook-Secret: "{{secrets.CRM_WEBHOOK_SECRET}}"
body: |
  {
    "event": "order.created",
    "timestamp": "{{formatDate now 'ISO'}}",
    "data": {
      "orderId": "{{trigger.data.id}}",
      "customer": {
        "email": "{{trigger.data.customer.email}}",
        "name": "{{trigger.data.customer.name}}"
      },
      "amount": {{trigger.data.total}}
    }
  }
retries: 3
retryDelay: 5000
label: "CRM Webhook"

type: api
url: "https://api.example.com/resource"
rateLimit:
  maxRequests: 100
  perSeconds: 60
  queueExcess: true
  onLimitReached: delay  # delay, error, skip

1. Mai hardcodare API keys nel flow
2. Usa sempre {{secrets.KEY_NAME}}
3. Ruota le chiavi regolarmente
4. Usa scope minimali per OAuth

1. Configura sempre retries per API critiche
2. Usa condition per gestire errori
3. Implementa fallback per alta disponibilità
4. Logga sempre gli errori

1. Usa timeout appropriati
2. Implementa caching dove possibile
3. Usa batch requests quando supportati
4. Monitora rate limits