API இணைப்புகள்

எந்த HTTP API-யையும், உரையாடலின் நடுவில் உங்கள் ஏஜென்ட் அழைக்கக்கூடிய ஒரு செயல்பாடாக மாற்றுங்கள்: ஒரு cURL கட்டளையை ஒட்டுங்கள்; வழிகாட்டி கருவி வரையறை, அளவுருக்கள் மற்றும் அங்கீகாரத்தை உருவாக்கும்.

API இணைப்புகள் என்பது உரையாடலின்போது உங்கள் ஏஜென்ட்கள் அழைக்கக்கூடிய தனிப்பயன் HTTP செயல்பாடுகள் — ஆர்டரைத் தேடுதல், டிக்கெட்டை உருவாக்குதல், உங்கள் சொந்த பேக்கெண்டிலிருந்து கணக்கு நிலையைப் பெறுதல் போன்றவை. Connections → APIs (/dashboard/api-connections) என்பதன் கீழ் எண்ட்பாயிண்டை ஒருமுறை வரையறுக்கிறீர்கள்; இணைப்பு இணைக்கப்பட்டுள்ள ஏஜென்ட்கள், உரையாடலுக்குத் தேவைப்படும் போதெல்லாம் அதை அழைக்கலாம்.

ஒன்றை உருவாக்க இரண்டு வழிகள் உள்ளன: வழிகாட்டி பகுப்பாய்வு செய்யக்கூடிய ஒன்றை ஒட்டவும் அல்லது இணைப்பை கைமுறையாக அமைக்கவும்.

விரைவான வழி: ஒட்டி பகுப்பாய்வு செய்யவும்#

1. புதிய API இணைப்பைக் கிளிக் செய்யவும்

   உரையாடல் பெட்டி வழிகாட்டியில் திறக்கும். ஒரு மாதிரி cURL கட்டளை, OpenAPI/Swagger விவரக்குறிப்பு, Postman ஏற்றுமதி, TypeScript இடைமுகம், அல்லது Zod ஸ்கீமாவை பெட்டியில் ஒட்டவும்.

2. பகுப்பாய்வு என்பதைக் கிளிக் செய்யவும்

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

3. முன்னிலைப்படுத்தப்பட்ட புலங்களை உறுதிப்படுத்தவும்

   ஊகிக்கப்பட்ட உள்ளமைவு, மதிப்பாய்வுக்காக ஊகிக்கப்பட்ட புலங்கள் முன்னிலைப்படுத்தப்பட்ட நிலையில் திறக்கும். ஏஜென்ட் செயல்பாட்டை எப்போது, எவ்வாறு அழைக்க வேண்டும் என்பதைப் புரிந்துகொள்ள பெயர்கள், விளக்கங்கள், அளவுரு வகைகளைச் சரிசெய்யவும் — மாதிரி வாசிப்பது விளக்கம்தான்.

4. சரிபார்த்து சேமிக்கவும்

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

நீங்கள் ஒட்டியதில் வழிகாட்டியால் கோரிக்கை URL-ஐக் கண்டறிய முடியாவிட்டால், அது அதைக் கூறும் — முழுமையான http(s) எண்ட்பாயிண்டைச் சேர்த்து மீண்டும் முயற்சிக்கவும்.

கைமுறை அமைப்பு#

வழிகாட்டியில் கைமுறையாக அமைக்கவும் → என்பதைக் கிளிக் செய்யவும் (அல்லது திரும்பிச் செல்ல AI இதை ஊகிக்க வேண்டுமா? வழிகாட்டியை முயற்சிக்கவும் → என்பதைக் கிளிக் செய்யவும்). கைமுறை கட்டமைப்பியில் இரண்டு திருத்திகள் உள்ளன:

• காட்சிமுறை — காட்சிப் பெயர், செயல்பாட்டுப் பெயர், கோரிக்கை URL, முறை (POST, GET, PUT, PATCH, DELETE), தனிப்பயன் ஹெடர்கள், மற்றும் அளவுரு ஸ்கீமாவிற்கான படிவப் புலங்கள் (ஏஜென்ட் வழங்கக்கூடிய ஒவ்வொரு வாதத்திற்கும் பண்பைச் சேர்க்கவும்).
• JSON — நேரடியாக கருவி விவரக்குறிப்பை ஒட்டவோ நுணுக்கமாகச் சரிசெய்யவோ, மூல JSON ஆக அதே வரையறை.

ஒரு சோதனைக் கோரிக்கை பலகம் (விருப்பத்தேர்வு) சேமிப்பதற்கு முன் உள்ளமைக்கப்பட்ட கோரிக்கையை அனுப்ப உங்களை அனுமதிக்கும்; அது நிலை, தாமதம் மற்றும் பதில் முன்னோட்டத்தைக் காட்டும். சரிபார்த்து சேமிக்கவும் எப்போதும் இந்தச் சோதனையை இயக்கி, வெற்றி பெற்றால் மட்டுமே சேமிக்கும்.

உங்கள் இணைப்புகளை நிர்வகிக்கவும்#

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

• திருத்தவும் — உள்ளமைவை மீண்டும் திறக்கவும்.
• நகலெடுக்கவும் — தொடக்கப் புள்ளியாக அதை நகலெடுக்கவும் (நகல் சோதிக்கப்படாத நிலையில் தொடங்கும்).
• திருத்த வரலாறு — முந்தைய பதிப்புகளைப் பார்த்து ஒன்றைத் திருத்தியில் மீட்டமைக்கவும்.
• மாற்றவும் — நீங்கள் சேர்ந்துள்ள மற்றொரு நிறுவனத்திற்கு இணைப்பை நகலெடுக்கவும் அல்லது நகர்த்தவும். நகர்த்துவது அதை இங்கிருந்து அகற்றும்; அதைப் பயன்படுத்திய ஏஜென்ட்களுக்கு மறுஉள்ளமைவு தேவைப்படலாம்.
• நீக்கவும் — நிரந்தரமானது; இணைப்பைப் பயன்படுத்தும் ஏஜென்ட்கள் மறுஉள்ளமைக்கப்பட வேண்டும்.

அதை ஒரு ஏஜென்டுடன் இணைக்கவும்#

கட்டமைப்பியின் API இணைப்புகள் பிரிவில் ஒரு ஏஜென்டுடன் இணைப்பைச் சேர்க்கவும் (ஒரு ஏஜென்டை உருவாக்கவும்). ஒவ்வொரு இணைப்பையும் எந்த ஏஜென்ட்கள் பயன்படுத்துகின்றன என்பதைப் பட்டியல் காட்டும்; ஆகவே ஒரு மாற்றம் எதைப் பாதிக்கிறது என்பதை ஒரே பார்வையில் அறியலாம்.

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