Skip to main content

சர்வே API & MCP

imatic Survey உங்கள் ஸ்டாக்கின் மற்ற பகுதிகளுடன் இணைகிறது — பதில்களை உங்கள் சொந்த அமைப்புகளுக்குத் தள்ளுவது, படிவ வேலையை தானியக்கமாக்குவது, AI முகவர்களை உங்கள் படிவங்களுடன் வேலை செய்ய அனுமதிப்பது. இந்தப் பக்கம் டெவலப்பர் மேற்பரப்பை உள்ளடக்குகிறது: API keys, webhooks, REST API, MCP சர்வர், மற்றும் மின்னஞ்சல் வழங்கல். இந்த அம்சங்கள் இன்று நேரடியாகச் செயல்படுகின்றன.

ஒருங்கிணைப்புகள் மற்றும் டெவலப்பர் அமைப்புகள் பகுதி டெவலப்பர் பகுதி நீங்கள் API keys, webhooks, மற்றும் ஒருங்கிணைப்புகளை நிர்வகிக்கும் இடம்.

API keys​

API keys உங்கள் சொந்த ஆப்களையும் ஸ்கிரிப்ட்களையும் சர்வே REST API-க்கு எதிராக அங்கீகரிக்கின்றன. அவற்றை /developers/api-keys-ன் கீழ் உருவாக்கி நிர்வகியுங்கள், அங்கு நீங்கள் ஒரு கீயை வழங்கலாம், அதற்கு ஒரு பெயரிடலாம், அதன் பயன்பாட்டுப் புள்ளிவிவரங்களைப் பார்க்கலாம், எப்போதேனும் வெளிப்பட்டால் அதை ரத்து செய்யலாம்.

ஒரு கீ முழுமையாக ஒரே ஒரு முறை மட்டுமே காட்டப்படுகிறது, உருவாக்கும்போது — அப்போதே அதை நகலெடுத்து பாதுகாப்பான இடத்தில் சேமித்து வைக்கவும். அதற்குப் பிறகு நீங்கள் பட்டியலில் அதன் முன்னொட்டை மட்டுமே, அதன் பெயர், ஸ்கோப்கள், கடைசியாகப் பயன்படுத்திய நேரத்துடன் காண்பீர்கள்.

API ஆனது https://surveyapi.imatic.ai-இல் ஹோஸ்ட் செய்யப்பட்டுள்ளது, கீகள் sk_-முன்னொட்டுடன் இருக்கும். உங்கள் கீயை ஒரு Bearer டோக்கனாக அனுப்புங்கள். எண்ட்பாயிண்ட்கள் custom-verb POST கோரிக்கைகள் — எடுத்துக்காட்டாக, உங்கள் படிவங்களைப் பட்டியலிட:

curl -X POST https://surveyapi.imatic.ai/forms/list \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
கீகளை ரகசியமாக வைத்திருங்கள்

ஒரு API key-ஐ ஒரு கடவுச்சொல்லைப் போல நடத்துங்கள். அதை source control-க்கு கமிட் செய்யாதீர்கள், கசிந்திருக்கலாம் என்று சந்தேகித்தால் அதைச் சுழற்றுங்கள்.

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 படிவங்களையும் பதில்களையும் நிரல்வழியாக நிர்வகிக்க உங்களை அனுமதிக்கிறது. எண்ட்பாயிண்ட்கள் ஒரு பதிப்பிடப்பட்ட பாதை முன்னொட்டுக்குப் பதிலாக custom-verb POST கோரிக்கைகளைப் பயன்படுத்துகின்றன — எடுத்துக்காட்டாக, POST /forms/list (படிவங்களைப் பட்டியலிட), POST /forms/get-for-edit (ஒரு படிவத்தின் ஸ்கீமாவைப் படிக்க), POST /forms/generate (AI மூலம் ஒரு படிவத்தை உருவாக்க), POST /forms/duplicate, மற்றும் POST /forms/delete. இது https://surveyapi.imatic.ai-இல் ஹோஸ்ட் செய்யப்பட்டு, ஒரு API key மூலம் அங்கீகரிக்கப்படுகிறது — ஒரு sk_-முன்னொட்டு Bearer டோக்கன்.

AI முகவர்களுக்கான MCP சர்வர்​

MCP சர்வர் Model Context Protocol மூலம் சர்வேயை 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-ஐப் (நிறுவன-ஸ்கோப்) பயன்படுத்துகின்றன. REST API நீங்கள் /developers/api-keys-ன் கீழ் உருவாக்கும் ஒரு API key-ஐப் பயன்படுத்துகிறது. நீங்கள் அழைக்கும் மேற்பரப்புக்கு சரியான சான்றைத் தேர்ந்தெடுங்கள்.

மின்னஞ்சல் வழங்கல்​

மின்னஞ்சல் வழங்கல் (எடுத்துக்காட்டாக, பதில் அறிவிப்புகள்) /settings-ன் கீழ் மின்னஞ்சல்-வழங்கல் தாவலில் கட்டமைக்கப்படுகிறது. நீங்கள் ஆறு வழங்குநர்களில் எதையும் இணைக்கலாம்:

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

அடுத்த படிகள்​