பிற மென்பொருட்கள் உங்கள் தரவைப் படிக்க அனுமதிப்பது

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

காலப்போக்கில் அல்லது தாமதமாக, TRANXACT-க்கு வெளியே உள்ள ஏதோவொன்று உங்கள் தரவைக் கேட்கும்: ஒரு அறிக்கையிடல் கருவி, ஒரு கூட்டாளரின் அமைப்பு, விலைப்பட்டியல் தேவைப்படும் ஒரு இணையதளம், அல்லது உங்கள் வணிகத்தைப் பற்றி ஒரு கேள்வி கேட்கப்பட்ட ஒரு AI முகவர். API ஸ்டுடியோவில், 'பிளாட்ஃபார்ம்' என்பதன் கீழ், ஒரு நேரத்தில் ஒரு திரை, ஒரு நேரத்தில் ஒரு நெடுவரிசை என, அது எவ்வாறாக இருக்க அனுமதிக்கப்படுகிறது என்பதை நீங்கள் தீர்மானிக்கிறீர்கள்.

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

நான்கு முடிவுகள், வரிசைப்படி

ஒரு திரையை வெளியிடுதல்

1. பிளாட்ஃபார்ம் → ஏபிஐ ஸ்டுடியோவைத் திறந்து ஒரு திரையைத் தேர்ந்தெடுக்கவும். இந்தப் பட்டியலில், கன்சோலில் உள்ள அனைத்துத் திரைகளும் தயாரிப்பிலிருந்தே படிக்கப்பட்டு காட்டப்படும் — எனவே, இந்த வெளியீட்டில் இடம்பெற்ற ஒரு திரையும் அதில் இருக்கும்.
2. வெளியேறக்கூடிய நெடுவரிசைகளைக் குறியிடுங்கள். குறியிடப்படாத எதுவும் ஒருபோதும் அனுப்பப்படுவதில்லை: ஒரு பட்டியலிலோ, ஒரு தனிப்பட்ட பதிவிலோ, அல்லது ஒரு எழுதுதல் செயல்பாடு திருப்பித் தரும் தகவலிலோ கூட. வேண்டுமென்றே, தொடக்கத்திலிருந்தே எதுவும் குறியிடப்படுவதில்லை.
3. வினைச்சொற்களைத் தீர்மானியுங்கள். 'படித்தல்' என்பது இயல்பாகவே இயக்கத்தில் இருக்கும்; 'உருவாக்குதல்', 'மாற்றுதல்' மற்றும் 'நீக்குதல்' ஆகியவை ஒவ்வொன்றும் தனித்தனி முடிவுகளாகும், ஏனெனில் அவர்களின் கணினி அமைப்பை உங்கள் உருப்படி எழுத்தாளரைப் படிக்க அனுமதிப்பதும், அதை நீக்க அனுமதிப்பதும் ஒரே வாக்கியம் அல்ல.
4. விருப்பப்பட்டால் வரிசைகளைக் கட்டுப்படுத்தலாம் — பதிவிடப்பட்ட விலைப்பட்டியல்கள் மட்டும், இந்த ஆண்டுக்கானவை மட்டும். இது ஒவ்வொரு பட்டியல் திரையும் காட்டும் அதே வடிகட்டிதான்; ஒவ்வொரு அழைப்பின்போதும் சர்வரில் இது செயல்படுத்தப்படுகிறது, மேலும் அழைப்பாளர் அனுப்பும் எதனாலும் இதை விரிவாக்க முடியாது.
5. அதைச் சேமித்து வை. அது ஒரு வரைவு, ஒரு வரைவால் எதையும் சாதிக்க முடியாது. நீ அதைச் செய்ய நினைக்கும்போது, அதற்கு உயிர் கொடு.
6. யாருக்கும் சாவியைக் கொடுப்பதற்கு முன் முன்னோட்டத்தை அழுத்தவும். ஒரு கூட்டாளர் என்ன பெறுவார் என்பதையும், எத்தனை நெடுவரிசைகள் நிறுத்தி வைக்கப்பட்டுள்ளன என்பதையும் அது துல்லியமாகக் காட்டும்.

மென்பொருளைப் பதிவு செய்தல்

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

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

ஒரு சாவி எங்கிருந்து பயன்படுத்தப்படலாம்

அனுமதிக்கப்பட்ட முகவரிகள் இல்லாத ஒரு திறவுகோல் எதையும் சென்றடையாது. முகவரிகள் குறிப்பிடப்படாதது, இன்னும் சென்றடைய முடியாததாகவே கருதப்படும், மேலும் எங்கிருந்தும் சென்றடையக்கூடியதாக ஒருபோதும் கருதப்படாது. ஏனெனில், உலகில் உள்ள எந்த மடிக்கணினியிலிருந்தும் செயல்படும் ஒரு கசிந்த திறவுகோலே முழுமையான அபாயமாகும். நான்கு வகையான நுழைவுகள் உள்ளன: உலாவி மூலம், குறிப்பிடும் ஹோஸ்ட், ஒரு ஒற்றை முகவரி, அல்லது CIDR வடிவத்தில் உள்ள ஒரு பிணையம்.

ஒருங்கிணைக்கும் நபருக்கு என்ன அனுப்புவது

ஸ்டுடியோ நான்கு முகவரிகளை அச்சிடுகிறது. அடிப்படை முகவரி /api/v1, திறவுகோல் Authorization: Bearer ஹெடரில் இடம்பெறுகிறது, /api/v1/resources என்பது இந்தத் திறவுகோல் எவற்றையெல்லாம் சென்றடையலாம் என்பதைப் பட்டியலிடுகிறது, மற்றும் /api/v1/openapi.json என்பது ஒரு OpenAPI 3.1 ஆவணத்தைப் போன்றதே ஆகும்.

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

ஒரு AI முகவருக்கான அதே தரவு

/api/v1/mcp என்ற முகவரி ஒரு மாடல் கான்டெக்ஸ்ட் புரோட்டோகால் சர்வர் ஆகும். அதனுடன் இணையும் ஒரு ஏஜென்ட்டிற்கு, அதன் சாவி செய்யக்கூடிய ஒவ்வொரு செயலுக்கும் ஒரு கருவி மட்டுமே வழங்கப்படும், வேறு எதற்கும் அல்ல — யாரும் வெளியிடாத தரவுகளுக்கோ, யாரும் வழங்காத ஒரு வினைச்சொல்லுக்கோ கருவி இல்லை. இது ஒரு டெவலப்பருக்காக அல்லாமல், ஒரு மாடலுக்காக விவரிக்கப்பட்ட அதே வெளியீடுதான், எனவே இவ்விரண்டும் ஒருபோதும் ஒத்திசைவை இழக்காது.

ஒவ்வொரு அழைப்பிலும் என்ன நடக்கிறது

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

ஒவ்வொரு அழைப்பும், அனுமதிக்கப்பட்டதா அல்லது மறுக்கப்பட்டதா என்பது காரணத்துடன் பதிவு செய்யப்படுகிறது. அந்தப் பதிவேடு, பிளாட்ஃபார்ம் → ஏபிஐ ஸ்டுடியோ → ஏபிஐ அழைப்புப் பதிவு (Platform → API Studio → API Call Log) என்பதன் கீழ் உள்ளது. மேலும், யாரும் அனுமதிக்காத ஒரு முகவரியிலிருந்து வழங்கப்பட்ட திறவுகோல் என்பதே அது உருவாக்கும் மிகவும் சுவாரஸ்யமான வரியாகும்.

அது வேலை செய்யாதபோது