API કનેક્શન્સ

કોઈપણ HTTP API ને એવા ફંક્શનમાં ફેરવો જેને તમારો એજન્ટ વાતચીત દરમિયાન કૉલ કરી શકે: cURL કમાન્ડ પેસ્ટ કરો અને વિઝાર્ડ ટૂલની વ્યાખ્યા, પેરામીટર્સ અને ઑથ બનાવે છે.

API કનેક્શન્સ કસ્ટમ HTTP ફંક્શન્સ છે જેને તમારા એજન્ટ્સ વાતચીત દરમિયાન કૉલ કરી શકે છે — ઑર્ડર શોધવો, ટિકિટ બનાવવી, તમારા પોતાના બૅકએન્ડમાંથી એકાઉન્ટની સ્થિતિ મેળવવી. તમે કનેક્શન્સ → 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 કનેક્શન્સ વિભાગમાં એજન્ટ સાથે કનેક્શન ઉમેરો (એજન્ટ બનાવો). સૂચિ દર્શાવે છે કે દરેક કનેક્શનનો ઉપયોગ કયા એજન્ટ્સ કરે છે, જેથી ફેરફારની અસર શું થશે તે તમે એક નજરમાં જાણી શકો છો.

આગળના પગલાં#