Survey API ಮತ್ತು MCP

imatic Survey ನಿಮ್ಮ ಉಳಿದ ಸ್ಟ್ಯಾಕ್‌ಗೆ ಸಂಪರ್ಕಿಸುತ್ತದೆ — ಪ್ರತಿಕ್ರಿಯೆಗಳನ್ನು ನಿಮ್ಮ ಸ್ವಂತ ವ್ಯವಸ್ಥೆಗಳಿಗೆ ತಳ್ಳುತ್ತದೆ, ಫಾರ್ಮ್ ಕೆಲಸವನ್ನು ಸ್ವಯಂಚಾಲಿತಗೊಳಿಸುತ್ತದೆ, ಮತ್ತು AI ಏಜೆಂಟ್‌ಗಳಿಗೆ ನಿಮ್ಮ ಫಾರ್ಮ್‌ಗಳ ಜೊತೆ ಕೆಲಸ ಮಾಡಲು ಅವಕಾಶ ನೀಡುತ್ತದೆ. ಈ ಪುಟವು ಡೆವಲಪರ್ ಮೇಲ್ಮೈಯನ್ನು ಒಳಗೊಂಡಿದೆ: API ಕೀಗಳು, webhooks, REST API, MCP ಸರ್ವರ್, ಮತ್ತು ಇಮೇಲ್ ವಿತರಣೆ. ಈ ವೈಶಿಷ್ಟ್ಯಗಳು ಇಂದು ಲೈವ್ ಆಗಿವೆ.

ಡೆವಲಪರ್ ಪ್ರದೇಶವು ನೀವು API ಕೀಗಳು, webhooks, ಮತ್ತು ಇಂಟಿಗ್ರೇಷನ್‌ಗಳನ್ನು ನಿರ್ವಹಿಸುವ ಸ್ಥಳವಾಗಿದೆ.

API ಕೀಗಳು

API ಕೀಗಳು Survey REST API ವಿರುದ್ಧ ನಿಮ್ಮ ಸ್ವಂತ ಆ್ಯಪ್‌ಗಳು ಮತ್ತು ಸ್ಕ್ರಿಪ್ಟ್‌ಗಳನ್ನು ದೃಢೀಕರಿಸುತ್ತವೆ. ಅವುಗಳನ್ನು /developers/api-keys ಅಡಿಯಲ್ಲಿ ರಚಿಸಿ ಮತ್ತು ನಿರ್ವಹಿಸಿ, ಇಲ್ಲಿ ನೀವು ಕೀ ಬಿಡುಗಡೆ ಮಾಡಬಹುದು, ಅದಕ್ಕೆ ಹೆಸರು ನೀಡಬಹುದು, ಅದರ ಬಳಕೆ ಅಂಕಿಅಂಶಗಳನ್ನು ನೋಡಬಹುದು, ಮತ್ತು ಅದು ಎಂದಾದರೂ ಬಹಿರಂಗಗೊಂಡರೆ ರದ್ದುಗೊಳಿಸಬಹುದು.

ಕೀ ಅನ್ನು ರಚನೆಯ ಸಮಯದಲ್ಲಿ ಒಮ್ಮೆ ಮಾತ್ರ ಪೂರ್ಣವಾಗಿ ತೋರಿಸಲಾಗುತ್ತದೆ — ಆಗ ಅದನ್ನು ನಕಲಿಸಿ ಮತ್ತು ಸುರಕ್ಷಿತ ಸ್ಥಳದಲ್ಲಿ ಸಂಗ್ರಹಿಸಿ. ಅದರ ನಂತರ ನೀವು ಪಟ್ಟಿಯಲ್ಲಿ ಅದರ ಹೆಸರು, ಸ್ಕೋಪ್‌ಗಳು, ಮತ್ತು ಕೊನೆಯ-ಬಳಸಿದ ಸಮಯದ ಜೊತೆಗೆ ಅದರ ಪೂರ್ವಪ್ರತ್ಯಯವನ್ನು (prefix) ಮಾತ್ರ ನೋಡುತ್ತೀರಿ.

API ಅನ್ನು https://surveyapi.imatic.ai ನಲ್ಲಿ ಹೋಸ್ಟ್ ಮಾಡಲಾಗಿದೆ, ಮತ್ತು ಕೀಗಳು sk_-ಪೂರ್ವಪ್ರತ್ಯಯವುಳ್ಳವು. ನಿಮ್ಮ ಕೀ ಅನ್ನು Bearer ಟೋಕನ್ ಆಗಿ ಕಳುಹಿಸಿ. ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು ಕಸ್ಟಮ್-ವರ್ಬ್ POST ವಿನಂತಿಗಳಾಗಿವೆ — ಉದಾಹರಣೆಗೆ, ನಿಮ್ಮ ಫಾರ್ಮ್‌ಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡಲು:

curl -X POST https://surveyapi.imatic.ai/forms/list \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

ಕೀಗಳನ್ನು ಗೌಪ್ಯವಾಗಿ ಇರಿಸಿ

API ಕೀ ಅನ್ನು ಪಾಸ್‌ವರ್ಡ್‌ನಂತೆ ಪರಿಗಣಿಸಿ. ಅದನ್ನು ಸೋರ್ಸ್ ಕಂಟ್ರೋಲ್‌ಗೆ ಕಮಿಟ್ ಮಾಡಬೇಡಿ, ಮತ್ತು ಅದು ಸೋರಿಕೆಯಾಗಿದೆ ಎಂದು ಶಂಕಿಸಿದರೆ ಅದನ್ನು ತಿರುಗಿಸಿ (rotate).

Webhooks

Webhooks ನೀವು ನಿಯಂತ್ರಿಸುವ URL ಗೆ ಈವೆಂಟ್‌ಗಳನ್ನು ತಳ್ಳುತ್ತವೆ, ಆದ್ದರಿಂದ ಬದಲಾವಣೆಗಳಿಗಾಗಿ ಪೋಲಿಂಗ್ ಮಾಡುವ ಬದಲು ಏನಾದರೂ ಸಂಭವಿಸಿದ ಕ್ಷಣದಲ್ಲಿಯೇ ನಿಮ್ಮ ವ್ಯವಸ್ಥೆಗಳು ಪ್ರತಿಕ್ರಿಯಿಸುತ್ತವೆ. ಅವುಗಳನ್ನು /developers/webhooks ಅಡಿಯಲ್ಲಿ ಕಾನ್ಫಿಗರ್ ಮಾಡಿ.

ಲಭ್ಯ ಈವೆಂಟ್‌ಗಳು:

• response.created — ಹೊಸ ಪ್ರತಿಕ್ರಿಯೆ ಸಲ್ಲಿಸಿದಾಗ ಫೈರ್ ಆಗುತ್ತದೆ.
• response.flagged (ಯೋಜಿತ — ಇನ್ನೂ ಹೊರಸೂಸಲಾಗಿಲ್ಲ) — ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಫ್ಲ್ಯಾಗ್ ಮಾಡಿದಾಗ (ಉದಾಹರಣೆಗೆ, ವಂಚನೆ ಅಥವಾ ಸ್ಪ್ಯಾಮ್ ಪರಿಶೀಲನೆಗಳಿಂದ) ಫೈರ್ ಆಗುತ್ತದೆ.
• response.updated (ಯೋಜಿತ — ಇನ್ನೂ ಹೊರಸೂಸಲಾಗಿಲ್ಲ) — ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ನವೀಕರಿಸಿದಾಗ ಅಥವಾ ಮಾಡರೇಟ್ ಮಾಡಿದಾಗ ಫೈರ್ ಆಗುತ್ತದೆ.
• form.published (ಯೋಜಿತ — ಇನ್ನೂ ಹೊರಸೂಸಲಾಗಿಲ್ಲ) — ಫಾರ್ಮ್ ಪ್ರಕಟಿಸಿದಾಗ ಫೈರ್ ಆಗುತ್ತದೆ.
• form.closed (ಯೋಜಿತ — ಇನ್ನೂ ಹೊರಸೂಸಲಾಗಿಲ್ಲ) — ಫಾರ್ಮ್ ಮುಚ್ಚಿದಾಗ ಫೈರ್ ಆಗುತ್ತದೆ.

ಪ್ರತಿ ವಿತರಣೆಯನ್ನು HMAC-SHA256 ಸಹಿಯೊಂದಿಗೆ ಸಹಿ ಮಾಡಲಾಗುತ್ತದೆ (X-Signature ಹೆಡರ್‌ನಲ್ಲಿ, X-Timestamp, X-Event-Id, ಮತ್ತು X-Event-Type ಜೊತೆಗೆ ಕಳುಹಿಸಲಾಗುತ್ತದೆ), ಇದರಿಂದ ನಿಮ್ಮ ಎಂಡ್‌ಪಾಯಿಂಟ್ ವಿನಂತಿಯು ನಿಜವಾಗಿಯೂ imatic Survey ನಿಂದ ಬಂದಿದೆ ಮತ್ತು ಸಾಗಣೆಯ ಸಮಯದಲ್ಲಿ ಯಾವುದೇ ಬದಲಾವಣೆ ಆಗಿಲ್ಲ ಎಂದು ಪರಿಶೀಲಿಸಬಹುದು. ವಿಫಲವಾದ ವಿತರಣೆಗಳನ್ನು ವಿಫಲ ಎಂದು ಗುರುತಿಸುವ ಮೊದಲು ಎಕ್ಸ್‌ಪೋನೆನ್ಷಿಯಲ್ ಬ್ಯಾಕ್‌ಆಫ್‌ನೊಂದಿಗೆ ಮರುಪ್ರಯತ್ನಿಸಲಾಗುತ್ತದೆ.

REST API

REST API ನಿಮಗೆ ಫಾರ್ಮ್‌ಗಳು ಮತ್ತು ಪ್ರತಿಕ್ರಿಯೆಗಳನ್ನು ಪ್ರೋಗ್ರಾಮ್ಯಾಟಿಕಲ್ ಆಗಿ ನಿರ್ವಹಿಸಲು ಅವಕಾಶ ನೀಡುತ್ತದೆ. ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು ಆವೃತ್ತಿ-ನಿಯಂತ್ರಿತ ಪಾಥ್ ಪೂರ್ವಪ್ರತ್ಯಯದ ಬದಲಿಗೆ ಕಸ್ಟಮ್-ವರ್ಬ್ POST ವಿನಂತಿಗಳನ್ನು ಬಳಸುತ್ತವೆ — ಉದಾಹರಣೆಗೆ, POST /forms/list (ಫಾರ್ಮ್‌ಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡಿ), POST /forms/get-for-edit (ಫಾರ್ಮ್‌ನ ಸ್ಕೀಮಾ ಓದಿ), POST /forms/generate (AI ನೊಂದಿಗೆ ಫಾರ್ಮ್ ರಚಿಸಿ), POST /forms/duplicate, ಮತ್ತು POST /forms/delete. ಇದನ್ನು https://surveyapi.imatic.ai ನಲ್ಲಿ ಹೋಸ್ಟ್ ಮಾಡಲಾಗಿದೆ ಮತ್ತು API ಕೀ ಯೊಂದಿಗೆ ದೃಢೀಕರಿಸಲಾಗಿದೆ — sk_-ಪೂರ್ವಪ್ರತ್ಯಯವುಳ್ಳ Bearer ಟೋಕನ್.

AI ಏಜೆಂಟ್‌ಗಳಿಗಾಗಿ MCP ಸರ್ವರ್

MCP ಸರ್ವರ್ Model Context Protocol ಮೂಲಕ Survey ಅನ್ನು AI ಏಜೆಂಟ್‌ಗಳಿಗೆ ತೆರೆದಿಡುತ್ತದೆ, ಇದರಿಂದ ಸಹಾಯಕ ನಿಮ್ಮ ಪರವಾಗಿ ನಿಮ್ಮ ಫಾರ್ಮ್‌ಗಳು ಮತ್ತು ಪ್ರತಿಕ್ರಿಯೆಗಳ ಜೊತೆ ಕೆಲಸ ಮಾಡಬಹುದು. ಇದು POST /mcp ಮೇಲೆ JSON-RPC 2.0 ಮಾತನಾಡುತ್ತದೆ ಮತ್ತು ನಿಮ್ಮ ಪೋರ್ಟಲ್ JWT ನೊಂದಿಗೆ ದೃಢೀಕರಿಸಲಾಗಿದೆ (Bearer ಟೋಕನ್ ಆಗಿ ಕಳುಹಿಸಲಾಗಿದೆ), ಇದು ಪ್ರತಿ ಕರೆಯನ್ನು ನಿಮ್ಮ ಸಂಸ್ಥೆಗೆ ಸ್ಕೋಪ್ ಮಾಡುತ್ತದೆ.

ಇದು 10 ಉಪಕರಣಗಳೊಂದಿಗೆ ಬರುತ್ತದೆ:

• whoami — ದೃಢೀಕರಿಸಿದ ಸಂಸ್ಥೆಯ ಸಂದರ್ಭವನ್ನು ಹಿಂದಿರುಗಿಸುತ್ತದೆ.
• list_forms — ನಿಮ್ಮ ಪ್ರಕಟಿತ ಫಾರ್ಮ್‌ಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡುತ್ತದೆ.
• get_form — ಫಾರ್ಮ್‌ನ ಸ್ಕೀಮಾ ಮತ್ತು ಫೀಲ್ಡ್‌ಗಳನ್ನು ಓದುತ್ತದೆ.
• submit_response — ಫಾರ್ಮ್‌ಗೆ ಪ್ರತಿಕ್ರಿಯೆ ಸಲ್ಲಿಸುತ್ತದೆ.
• list_responses — ಪ್ರತಿಕ್ರಿಯೆಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡುತ್ತದೆ (ಪುಟಗೊಳಿಸಲಾಗಿದೆ).
• get_response — ಒಂದೇ ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಓದುತ್ತದೆ.
• get_response_stats — ಒಟ್ಟುಗೂಡಿಸಿದ ಪ್ರತಿಕ್ರಿಯೆ ಅಂಕಿಅಂಶಗಳನ್ನು ಓದುತ್ತದೆ.
• create_poll — ಒಂದೇ-ಪ್ರಶ್ನೆಯ ಪೋಲ್ ರಚಿಸಿ ಪ್ರಕಟಿಸುತ್ತದೆ.
• cast_vote — ಪೋಲ್‌ನಲ್ಲಿ ಮತ ಚಲಾಯಿಸುತ್ತದೆ.
• live_poll_results — ಲೈವ್ ಪೋಲ್ ಎಣಿಕೆಗಳನ್ನು ಓದುತ್ತದೆ.

ಎರಡು ವಿಭಿನ್ನ ಕ್ರೆಡೆನ್ಷಿಯಲ್‌ಗಳು

MCP ಸರ್ವರ್ ಮತ್ತು webhooks ನಿಮ್ಮ ಪೋರ್ಟಲ್ JWT (org-scoped) ಬಳಸುತ್ತವೆ. REST API /developers/api-keys ಅಡಿಯಲ್ಲಿ ನೀವು ರಚಿಸುವ API ಕೀ ಬಳಸುತ್ತದೆ. ನೀವು ಕರೆ ಮಾಡುತ್ತಿರುವ ಮೇಲ್ಮೈಗೆ ಸರಿಯಾದ ಕ್ರೆಡೆನ್ಷಿಯಲ್ ಆಯ್ಕೆ ಮಾಡಿ.

ಇಮೇಲ್ ವಿತರಣೆ

ಇಮೇಲ್ ವಿತರಣೆ (ಉದಾಹರಣೆಗೆ, ಪ್ರತಿಕ್ರಿಯೆ ಅಧಿಸೂಚನೆಗಳು) ಅನ್ನು ಇಮೇಲ್-ವಿತರಣೆ ಟ್ಯಾಬ್‌ನಲ್ಲಿ /settings ಅಡಿಯಲ್ಲಿ ಕಾನ್ಫಿಗರ್ ಮಾಡಲಾಗುತ್ತದೆ. ನೀವು ಆರು ಪ್ರೊವೈಡರ್‌ಗಳ ಪೈಕಿ ಯಾವುದನ್ನಾದರೂ ಸಂಪರ್ಕಿಸಬಹುದು:

• Gmail
• Resend
• SendGrid
• Postmark
• Amazon SES
• Custom SMTP

ಮುಂದಿನ ಹಂತಗಳು

• ಫಾರ್ಮ್ ಪ್ರಕಟಿಸಿ ಮತ್ತು ಹಂಚಿಕೊಳ್ಳಿ
• ಪ್ರತಿಕ್ರಿಯೆಗಳನ್ನು ವೀಕ್ಷಿಸಿ
• ವಿಶ್ಲೇಷಣೆ ತೆರೆಯಿರಿ
• AI ನೊಂದಿಗೆ ಫಾರ್ಮ್ ರಚಿಸಿ