API કનેક્શન્સ
API કનેક્શન્સ કસ્ટમ HTTP ફંક્શન્સ છે જેને તમારા એજન્ટ વાતચીત દરમિયાન કૉલ કરી શકે છે — ઑર્ડર શોધવા, ટિકિટ બનાવવા, તમારા પોતાના બેકએન્ડમાંથી એકાઉન્ટની સ્થિતિ મેળવવા માટે. તમે Connections → APIs (/dashboard/api-connections) હેઠળ એકવાર એન્ડપૉઇન્ટ નિર્ધારિત કરો છો; જે એજન્ટ સાથે કનેક્શન જોડાયેલું હોય તે વાતચીતમાં જરૂર પડે ત્યારે તેને ઇન્વોક કરી શકે છે.
એક બનાવવા માટે બે રીતો છે: વિઝાર્ડ વિશ્લેષણ કરી શકે તેવી વસ્તુ પેસ્ટ કરો અથવા કનેક્શન મેન્યુઅલી સેટ અપ કરો.
ઝડપી રીત: પેસ્ટ કરો અને વિશ્લેષણ કરો
- નવું API કનેક્શન ક્લિક કરો
ડાયલૉગ વિઝાર્ડ પર ખૂલે છે. બૉક્સમાં નમૂનાનો cURL કમાન્ડ, OpenAPI/Swagger સ્પેક, Postman એક્સપોર્ટ, TypeScript ઇન્ટરફેસ, અથવા Zod સ્કીમા પેસ્ટ કરો.
- વિશ્લેષણ કરો ક્લિક કરો
ThunderPhone તમારા પેસ્ટમાંથી સંપૂર્ણ કનેક્શન અનુમાને છે — URL, મેથડ, હેડર્સ અને તેને મળેલા ક્વેરી પેરામીટર્સ તથા રિક્વેસ્ટ બૉડીમાંથી મેળવેલી પેરામીટર સ્કીમા. તમે પેસ્ટ કરેલા હેડર્સ (ઑથ હેડર્સ સહિત) એન્ડપૉઇન્ટ કન્ફિગરેશનમાં સામેલ થાય છે.
- હાઇલાઇટ કરેલા ફીલ્ડ્સની પુષ્ટિ કરો
અનુમાનિત કન્ફિગરેશન સમીક્ષા માટે અનુમાનિત ફીલ્ડ્સ હાઇલાઇટ કરીને ખૂલે છે. નામો, વર્ણનો અને પેરામીટર પ્રકારો સમાયોજિત કરો જેથી એજન્ટ સમજી શકે કે ફંક્શન ક્યારે અને કેવી રીતે કૉલ કરવું — મોડેલ વર્ણન વાંચે છે.
- માન્ય કરો અને સાચવો
સાચવતા પહેલાં તમારા એન્ડપૉઇન્ટ સામે લાઇવ ટેસ્ટ રિક્વેસ્ટ ચલાવવામાં આવે છે. જો રિક્વેસ્ટ નિષ્ફળ જાય, તો કનેક્શન સાચવવામાં આવતું નથી — URL, ઑથ હેડર્સ અથવા બૉડી સુધારીને ફરી પ્રયાસ કરો. સફળતા પર કનેક્શન માન્ય કરેલ બૅજ સાથે સંગ્રહિત થાય છે.
જો વિઝાર્ડને તમારા પેસ્ટમાં રિક્વેસ્ટ URL ન મળે, તો તે તમને જણાવશે —
પૂર્ણ http(s) એન્ડપૉઇન્ટ સામેલ કરો અને ફરી પ્રયાસ કરો.
મેન્યુઅલ સેટઅપ
વિઝાર્ડમાં મેન્યુઅલી સેટ અપ કરો → ક્લિક કરો (અથવા પાછા જવા માટે AI ને આ અનુમાન કરવા દો? વિઝાર્ડ અજમાવો →). મેન્યુઅલ બિલ્ડરમાં બે એડિટર છે:
- વિઝ્યુઅલ — ડિસ્પ્લે નામ, ફંક્શન નામ, રિક્વેસ્ટ
URL, મેથડ (
POST,GET,PUT,PATCH,DELETE), કસ્ટમ હેડર્સ, અને પેરામીટર સ્કીમા માટેના ફૉર્મ ફીલ્ડ્સ (એજન્ટ આપી શકે તેવી દરેક દલીલ માટે પ્રૉપર્ટી ઉમેરો). - JSON — સીધું ટૂલ સ્પેક પેસ્ટ કરવા અથવા ફાઇન-ટ્યુન કરવા માટે, રૉ JSON તરીકેની એ જ વ્યાખ્યા.
ટેસ્ટ રિક્વેસ્ટ પૅનલ (વૈકલ્પિક) તમને સાચવતા પહેલાં કન્ફિગર કરેલી રિક્વેસ્ટ મોકલવા દે છે અને સ્થિતિ, વિલંબ તથા રિસ્પૉન્સ પ્રીવ્યૂ દર્શાવે છે. માન્ય કરો અને સાચવો હંમેશા આ ટેસ્ટ ચલાવે છે અને ફક્ત સફળતા પર જ સાચવે છે.
તમારા કનેક્શન્સ મેનેજ કરો
દરેક કનેક્શન પંક્તિ તેની માન્યતા સ્થિતિ — માન્ય કરેલ, પરીક્ષણ ન કરેલ, અથવા ભૂલ — તેનું ફંક્શન નામ અને કયા એજન્ટ તેનો ઉપયોગ કરે છે તે દર્શાવે છે. પંક્તિના ઍક્શન મેનૂમાંથી તમે આ કરી શકો છો:
- સંપાદિત કરો — કન્ફિગરેશન ફરી ખોલો.
- ક્લોન કરો — પ્રારંભિક બિંદુ તરીકે તેની નકલ બનાવો (નકલ પરીક્ષણ ન કરેલ સ્થિતિથી શરૂ થાય છે).
- રિવિઝન ઇતિહાસ — અગાઉના સંસ્કરણો જુઓ અને એકને એડિટરમાં પુનઃસ્થાપિત કરો.
- ટ્રાન્સફર કરો — તમે જે બીજી સંસ્થાના સભ્ય છો તેમાં કનેક્શનની નકલ કરો અથવા ખસેડો. ખસેડવાથી તે અહીંથી દૂર થાય છે; તેનો ઉપયોગ કરતા એજન્ટને ફરી કન્ફિગર કરવાની જરૂર પડી શકે છે.
- કાઢી નાખો — કાયમી છે; કનેક્શનનો ઉપયોગ કરતા એજન્ટને ફરી કન્ફિગર કરવાની જરૂર પડશે.
તેને એજન્ટ સાથે જોડો
બિલ્ડરના API કનેક્શન્સ વિભાગમાં એજન્ટ સાથે કનેક્શન ઉમેરો (એજન્ટ બનાવો). સૂચિ દર્શાવે છે કે કયા એજન્ટ દરેક કનેક્શનનો ઉપયોગ કરે છે, જેથી કોઈ ફેરફારની અસર તમે તરત જાણી શકો.