API வார்மர்கள்

REST மற்றும் GraphQL இறுதிப்புள்ளிகளை சூடாக வைத்திருங்கள், உண்மையான முறைகள், தலைப்புகள், குக்கீகள், உடல்கள் மற்றும் config matrices ஆகியவற்றுடன்.

13 நிமிட வாசிப்பு

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

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

வெப்சைட் வார்மர்களில் இருந்து பிரிக்கவும்

API வார்மர்கள் அவற்றின் சொந்த உரிமையுடன் ஒரு தனித்துவமான அம்சமாகும். பிரிவு காணவில்லை அல்லது பூட்டப்பட்டிருந்தால், உங்கள் திட்டத்தில் அவை சேர்க்கப்படவில்லை - திட்டங்கள் மற்றும் வரம்புகள் பார்க்கவும்.

ஒன்றை எப்போது பயன்படுத்த வேண்டும்

சூழ்நிலை	API வார்மர் ஏன் உதவுகிறது
தலையில்லாத கடை முகப்பு அல்லது தளம்	தயாரிப்பு, இருப்பு மற்றும் உள்ளடக்கம் JSON ரெண்டரின் ஒவ்வொரு பக்கத்திலும் பெறப்படும். அந்த வழிகளை வெப்பமாக்குவது முழு முன் முனையையும் வேகமாக வைத்திருக்கும்.
ஒரு பொது டெவலப்பர் API	பிரபலமான இறுதிப்புள்ளிகள் மற்றும் ஆவணப்படுத்தல் எடுத்துக்காட்டுகள் யார் முதலில் அழைத்தாலும் மெதுவாக செயல்படுவதற்குப் பதிலாக பதிலளிக்கக்கூடியதாக இருக்கும்.
ஒரு பின்தளத்தில்-முன்பக்க அடுக்கு	பல சேவைகளை ஈர்க்கும் ஒருங்கிணைக்கப்பட்ட இறுதிப்புள்ளிகளை மீண்டும் உருவாக்குவதற்கு அதிக செலவு பிடிக்கும். அவற்றை வெப்பமாக்குவது மொபைல் மற்றும் இணைய வாடிக்கையாளர்களைப் பாதுகாக்கிறது.
கனமான GraphQL செயல்பாடுகள்	ஒரு சில வினவல்கள் பொதுவாக போக்குவரத்தில் ஆதிக்கம் செலுத்துகின்றன. ஒருமுறை `/graphql` ஐ அழுத்துவதை விட, குறிப்பிட்ட செயல்பாடுகளை வெப்பமாக்குவது மிகவும் முக்கியமானது.

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

API வார்மரை உருவாக்குகிறது

1
API ஹோஸ்ட்பெயரை சரிபார்க்கவும்
எண்ட்பாயிண்ட் URLs ஆனது வெப்சைட் வார்மர்களைப் போலவே சரிபார்க்கப்பட்ட ஹோஸ்ட்பெயரைப் பயன்படுத்த வேண்டும். ஹோஸ்ட்பெயர் சரிபார்ப்பு பார்க்கவும்.
2
வார்மருக்கு பெயரிட்டு அதை செயலற்ற நிலையில் விடவும்
முதலில் உள்ளமைக்கவும், நீங்கள் திருப்தி அடையும்போது செயல்படுத்தவும்.
3
ஒன்று அல்லது அதற்கு மேற்பட்ட இறுதிப்புள்ளிகளைச் சேர்க்கவும்
ஒவ்வொரு இறுதிப்புள்ளியும் URL மற்றும் HTTP முறை மற்றும் விருப்பமாக லேபிள், உடல் மற்றும் உள்ளடக்க வகை ஆகியவற்றைக் கொண்டுள்ளது.
4
இறுதிப்புள்ளிக்கு தேவைப்பட்டால் அங்கீகாரத்தைச் சேர்க்கவும்
உலகளாவிய தலைப்புகளும் குக்கீகளும் வார்மர் செய்யும் ஒவ்வொரு கோரிக்கைக்கும் பயன்படுத்தப்படும்.
5
விருப்பமாக ஒரு config matrix உடன் விரிவாக்கவும்
கிட்டத்தட்ட ஒரே மாதிரியான வார்மர்களை உருவாக்காமல் பல மாறுபாடுகளை - லோக்கல்கள், குத்தகைதாரர்கள், ஐடிகள் - கவர்.
6
விகிதம் மற்றும் இடைவெளிகளை அமைத்து, பின்னர் செயல்படுத்தவும்
வெப்சைட் வார்மர்களின் அதே யோசனை: உங்கள் கேச் TTLஐ வெல்லும் அளவுக்கு அடிக்கடி சூடாகவும், காயப்படுத்தாதபடி மெதுவாகவும்.

இறுதிப்புள்ளிகள்

வார்மரில் உள்ள ஒவ்வொரு முனைப்புள்ளியும் தனித்தனியாக கட்டமைக்கப்படுகிறது:

லேபிள்: மனிதனால் படிக்கக்கூடிய விருப்பமான பெயர், எனவே இறுதிப்புள்ளிகளின் நீண்ட பட்டியல் படிக்கக்கூடியதாக இருக்கும்.
WordPress: சரிபார்க்கப்பட்ட ஹோஸ்ட்பெயரில் முழு இறுதிப்புள்ளி முகவரி. PATH பரிமாணத்துடன் இணைக்கப்படும் போது {id} அல்லது :id போன்ற பாதை ஒதுக்கிடங்களைக் கொண்டிருக்கலாம்.
முறை: உங்கள் திட்டத்தைப் பொறுத்து GET, POST மற்றும் பிற. திட்டங்கள் பொதுவாக GET மற்றும் HEAD ஐ இயல்புநிலையாக அனுமதிக்கும், உயர் அடுக்குகளில் அதிக முறைகள் உள்ளன.
நெறிமுறை: REST அல்லது GRAPHQL. GraphQL ஐ தேர்வு செய்வது செயல்பாடு மற்றும் வினவல் புலங்களை வெளிப்படுத்துகிறது.
உடல் டெம்ப்ளேட்டைக் கோரவும்: அனுப்ப வேண்டிய உடல், ஒன்றை எடுத்துச் செல்லும் முறைகளுக்கு. API கோரிக்கை உடல் உரிமை தேவை.
WordPress: கோரிக்கை அமைப்பின் உள்ளடக்க வகை, பொதுவாக application/json.
உணர்ச்சியற்றவர்: இருமுறை அழைப்பது பாதுகாப்பானது என இறுதிப்புள்ளியைக் குறிக்கிறது, குளிர்/சூடான இரட்டைப் பெறுதலைச் செயல்படுத்துகிறது, இது முன்னேற்றத்தை அளவிடும். உண்மையாக இரண்டு முறை அழைக்கும் போது மட்டும் அதை இயக்கினால் பக்க விளைவுகள் இல்லை.
இயக்கப்பட்டது: இந்த குறிப்பிட்ட இறுதிப்புள்ளி ரன்களில் சேர்க்கப்பட்டுள்ளதா. ஒரு இறுதிப்புள்ளியை நீக்காமல் தற்காலிகமாக முடக்குவது எளிது.

எழுதும் செயல்பாடுகள் பலவீனமானவை என்பதைக் குறிப்பதில் கவனமாக இருங்கள்

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

கட்டமைப்பு மெட்ரிக்குகள்

பெரும்பாலான ஏபிஐகள் மாறுபாடுகளைக் கொண்டுள்ளன: ஒவ்வொரு லோகேலுக்கும், ஒரு குத்தகைதாரருக்கும், ஒரு நாணயத்துக்கும் அல்லது ஐடிக்கும் ஒரே முடிவுப் புள்ளி. ஒவ்வொன்றிற்கும் ஒரு வெப்பத்தை உருவாக்குவது பராமரிக்க முடியாதது.

ஒரு config matrix இதை தீர்க்கிறது. நீங்கள் பல மதிப்புகளுடன் பரிமாணங்களை வரையறுக்கிறீர்கள், மேலும் Cache Rocket முழு கார்ட்டீசியன் தயாரிப்பை தனிப்பட்ட சூடான கோரிக்கைகளாக விரிவுபடுத்துகிறது.

பரிமாண வகை	மதிப்புகளை செலுத்துகிறது	உதாரணம்
WordPress	வினவல் சரம்	`/cart`, `/checkout`, `/my-account`
WordPress	ஒரு கோரிக்கை தலைப்பு	`X-Tenant: acme`, `X-Tenant: globex`
WordPress	ஒரு குக்கீ	`X-Tenant: acme`, `X-Tenant: globex`
WordPress	URL இல் A `{placeholder}`	`{id}` → `1`, `2`, `3`

ஒரு வேலை உதாரணம்

text

Endpoint:  GET https://api.example.com/v1/products/{category}

Dimensions:
  PATH   category = shoes, bags, hats
  QUERY  locale   = en, nl

Expands to 6 warm requests:
  /v1/products/shoes?locale=en
  /v1/products/shoes?locale=nl
  /v1/products/bags?locale=en
  /v1/products/bags?locale=nl
  /v1/products/hats?locale=en
  /v1/products/hats?locale=nl

சேர்க்கைகள் வேகமாக பெருகும்

மொத்த கோரிக்கைகள் ஒவ்வொரு பரிமாணத்தின் மதிப்பு எண்ணிக்கையின் தயாரிப்பு ஆகும். ஐந்து மதிப்புகளின் மூன்று பரிமாணங்கள் ஒவ்வொன்றும் ஒரு முனைப்புள்ளியிலிருந்து 125 சேர்க்கைகள் ஆகும். படிவம் இயங்கும் எண்ணிக்கையையும் உங்கள் திட்டத்தின் அதிகபட்சத்தையும் காட்டுகிறது — நீங்கள் மதிப்புகளைச் சேர்க்கும்போது அதைப் பார்க்கவும்.

நீங்கள் அதிகபட்ச திட்டத்தை மீறினால், வார்மர் சேமிக்காது. மதிப்புகளைக் குறைக்கவும், பல வெப்பமானிகளில் பிரிக்கவும் அல்லது மேம்படுத்தவும்.

அங்கீகாரம்

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

வழக்கமான அங்கீகார தலைப்புகள்

text

Authorization: Bearer YOUR_LONG_LIVED_TOKEN
X-Api-Key: YOUR_API_KEY

உண்மையான வாடிக்கையாளர்கள் உண்மையில் கோரும் மாறுபாட்டை சூடுபடுத்துங்கள்

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

டோக்கன்கள் காலாவதியாகின்றன. API வார்மர் திடீரென 401ஐத் திரும்பப் பெறத் தொடங்கினால், கடின குறியிடப்பட்ட டோக்கனைச் சரிபார்க்க வேண்டும்.

WordPress

GraphQL க்கு அதன் சொந்த சிகிச்சை தேவைப்படுகிறது, ஏனெனில் செயல்திறன் குறிப்பிட்ட செயல்பாட்டைப் பொறுத்தது, இறுதிப்புள்ளி பாதை அல்ல. ஒருமுறை /graphqlஐ அழுத்தினால் எதுவும் சொல்ல முடியாது; உங்கள் மூன்று கனமான வினவல்களை வெப்பமாக்குவது எல்லாவற்றையும் உங்களுக்குச் சொல்கிறது.

ஒரு இறுதிப்புள்ளியின் நெறிமுறையை GraphQLக்கு அமைத்து, பின்னர் வழங்கவும்:

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

Note

GraphQL வெப்பமயமாதல் அதன் சொந்த திட்ட உரிமையால், API வார்மர்களுக்கு மேல் உள்ளது.

OpenAPI இறக்குமதி

ஆதரிக்கப்படும் திட்டங்களில் நீங்கள் அவற்றை உள்ளிடுவதற்குப் பதிலாக OpenAPI 3 விவரக்குறிப்பிலிருந்து நேரடியாக இறுதிப்புள்ளிகளை இறக்குமதி செய்யலாம். கண்டுபிடிக்கப்பட்ட முனைப்புள்ளிகள் வெப்பமானவற்றில் சேர்க்கப்படுகின்றன, கத்தரிக்கவும் மற்றும் சரிசெய்யவும் தயாராக உள்ளன.

Tip

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

வரம்புகள் மற்றும் திட்டமிடல்

நிமிடத்திற்கு அதிகபட்ச வெப்பம்: இந்த API வார்மருக்கான உச்சவரம்பு, வெப்சைட் வார்மரில் நிமிடத்திற்கு அதிகபட்சம் URLsக்கு சமம்.
கோரிக்கை நேரம் முடிந்தது: விட்டுக்கொடுக்கும் முன் பதிலுக்காக எவ்வளவு காலம் காத்திருக்க வேண்டும்.
தானியங்கு தொடக்க இடைவெளி: வினாடிகளில் எவ்வளவு அடிக்கடி ஒரு புதிய சூடான பாஸ் தொடங்குகிறது.
என்கியூ இடைவெளி: சுழற்சியில் மீண்டும் வரிசைப்படுத்தப்பட்ட வேலையின் வேகம்.
HTTPSக்கு மீண்டும் எழுதவும்: http:// இறுதிப்புள்ளி URLs ஐ https:// க்கு மேம்படுத்தவும்.
சூடான அட்டவணை: பீக் மற்றும் ஆஃப்-பீக் ஜன்னல்கள், வெப்சைட் வார்மர்களின் அதே JSON வடிவம். மேம்பட்ட வெப்பமயமாதல் பார்க்கவும்.

உங்கள் திட்டம் API வார்மர்களின் எண்ணிக்கை, ஒரு வெப்பமானிக்கான எண்ட்பாயிண்ட்கள் மற்றும் ஒரு வெப்பமானிக்கான சேர்க்கைகள் ஆகியவற்றையும் வரம்பிடுகிறது.

பொதுவான பிரச்சனைகள்

அனைத்தும் 401 அல்லது 403 என்று திரும்பும்.: அங்கீகார தலைப்பு அல்லது குக்கீ காணவில்லை, தவறானது அல்லது காலாவதியானது. நீண்ட கால டோக்கன்கள் வழக்கமான குற்றவாளிகள் — டோக்கன் இன்னும் செல்லுபடியாகும் மற்றும் சுழற்றப்படவில்லை என்பதை சரிபார்க்கவும்.
பல சேர்க்கைகளை மேற்கோள் காட்டி, வார்மர் சேமிக்காது.: உங்கள் அணி அதிகபட்ச திட்டத்திற்கு அப்பால் விரிவடைகிறது. பரிமாண மதிப்புகளைக் குறைக்கவும், பல வெப்பமானிகளில் இறுதிப்புள்ளிகளைப் பிரிக்கவும் அல்லது மேம்படுத்தவும்.
எனக்கு தேவையான முறை கீழ்தோன்றலில் இல்லை.: எந்த HTTP முறைகள் அனுமதிக்கப்படுகின்றன என்பதைத் திட்டங்கள் கட்டுப்படுத்துகின்றன. கீழ் அடுக்குகள் பொதுவாக GET மற்றும் HEADஐ மட்டுமே அனுமதிக்கும்.
வெப்பமயமாதல் சுத்தமாக இயங்குகிறது ஆனால் உண்மையான வாடிக்கையாளர்களுக்கு பதில்கள் இன்னும் மெதுவாகவே இருக்கும்.: வாடிக்கையாளர்களின் கோரிக்கையை விட வேறு கேச் மாறுபாட்டை நீங்கள் நிரப்புகிறீர்கள் - பொதுவாக Authorization தலைப்பு, குக்கீ அல்லது தலைப்பின் காரணமாக உங்கள் CDN மாறுபடும். உண்மையான வாடிக்கையாளர் அனுப்பும் சரியான கோரிக்கையை வெப்பமானவர் அனுப்பும் கோரிக்கையுடன் ஒப்பிடவும்.
கையொப்பமிடப்பட்ட, குறுகிய கால டோக்கன் தேவைப்படும் இறுதிப் புள்ளியை நான் சூடேற்ற முடியுமா?: நம்பகமானதாக இல்லை, ஏனென்றால் வெப்பமானால் ஒரு ஓட்டத்திற்கு புதிய கையொப்பத்தை உருவாக்க முடியாது. தற்காலிகமாகச் சேமிக்கக்கூடிய அங்கீகரிக்கப்படாத மாறுபாட்டை வெளிப்படுத்தலாம் அல்லது அது பாதுகாப்பாக இருக்கும் நீண்ட கால சேவை டோக்கனைப் பயன்படுத்தவும்.