# Survey API ಮತ್ತು MCP


# Survey API ಮತ್ತು MCP

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

![ಇಂಟಿಗ್ರೇಷನ್‌ಗಳು ಮತ್ತು ಡೆವಲಪರ್ ಸೆಟ್ಟಿಂಗ್‌ಗಳ ಪ್ರದೇಶ](/img/screenshots/survey/integrations.png)
*ಡೆವಲಪರ್ ಪ್ರದೇಶವು ನೀವು API ಕೀಗಳು, webhooks, ಮತ್ತು ಇಂಟಿಗ್ರೇಷನ್‌ಗಳನ್ನು ನಿರ್ವಹಿಸುವ ಸ್ಥಳವಾಗಿದೆ.*

## API ಕೀಗಳು

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

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

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

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

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

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 ಕೀ](#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`** — ಲೈವ್ ಪೋಲ್ ಎಣಿಕೆಗಳನ್ನು ಓದುತ್ತದೆ.

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

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

:::

## ಇಮೇಲ್ ವಿತರಣೆ

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

- **Gmail**
- **Resend**
- **SendGrid**
- **Postmark**
- **Amazon SES**
- **Custom SMTP**

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

- [ಫಾರ್ಮ್ ಪ್ರಕಟಿಸಿ ಮತ್ತು ಹಂಚಿಕೊಳ್ಳಿ](./publishing-sharing)
- [ಪ್ರತಿಕ್ರಿಯೆಗಳನ್ನು ವೀಕ್ಷಿಸಿ](./responses)
- [ವಿಶ್ಲೇಷಣೆ ತೆರೆಯಿರಿ](./analytics)
- [AI ನೊಂದಿಗೆ ಫಾರ್ಮ್ ರಚಿಸಿ](./ai-generation)