API వార్మర్‌లు

వెబ్ పేజీల మాదిరిగానే APIలు చల్లగా ఉంటాయి. JSON ప్రతిస్పందనను నిర్మించడం ఖరీదైనది మరియు మీ CDN లేదా గేట్‌వే వద్ద కాష్ చేయబడితే, గడువు ముగిసిన తర్వాత మొదటి క్లయింట్ వెబ్‌సైట్ సందర్శకుడు చెల్లించే పెనాల్టీని చెల్లిస్తాడు.

API వార్మర్‌లు దాన్ని పరిష్కరిస్తుంది. అవి ఖాతా → API వార్మర్‌లు కింద వెబ్‌సైట్ వార్మర్‌ల నుండి విడిగా నిర్వహించబడతాయి మరియు వాటి స్వంత ప్లాన్ పరిమితులను కలిగి ఉంటాయి.

ఒకదాన్ని ఎప్పుడు ఉపయోగించాలి#

API వార్మర్ ఎప్పుడూ కాష్ చేయబడని లేదా ఒక్కో వినియోగదారుకు ప్రత్యేకంగా ఉండే ముగింపు పాయింట్‌లకు ఉపయోగపడదు మరియు అందువల్ల పూరించడానికి భాగస్వామ్య కాపీని కలిగి ఉండదు.

API వార్మర్‌ను సృష్టిస్తోంది#

1. 1

   API హోస్ట్ పేరును ధృవీకరించండి

   ఎండ్‌పాయింట్ URLs తప్పనిసరిగా వెబ్‌సైట్ వార్మర్‌ల వలె ధృవీకరించబడిన హోస్ట్ పేరును ఉపయోగించాలి. హోస్ట్ పేరు ధృవీకరణ చూడండి.

2. 2

   వార్మర్‌కు పేరు పెట్టండి మరియు దానిని నిష్క్రియంగా ఉంచండి

   ముందుగా కాన్ఫిగర్ చేయండి, మీరు సంతృప్తి చెందినప్పుడు సక్రియం చేయండి.

3. 3

   ఒకటి లేదా అంతకంటే ఎక్కువ ముగింపు పాయింట్లను జోడించండి

   ప్రతి ముగింపు బిందువు URL మరియు HTTP పద్ధతిని కలిగి ఉంటుంది మరియు ఐచ్ఛికంగా లేబుల్, శరీరం మరియు కంటెంట్ రకాన్ని కలిగి ఉంటుంది.

4. 4

   ఎండ్‌పాయింట్‌కు అవసరమైతే ప్రామాణీకరణను జోడించండి

   వార్మర్ చేసే ప్రతి అభ్యర్థనకు గ్లోబల్ హెడర్‌లు మరియు కుక్కీలు వర్తింపజేయబడతాయి.

5. 5

   ఐచ్ఛికంగా కాన్ఫిగర్ మ్యాట్రిక్స్‌తో విస్తరించండి

   డజన్ల కొద్దీ ఒకేలాంటి వార్మర్‌లను సృష్టించకుండా అనేక వేరియంట్‌లను కవర్ చేయండి - లొకేల్‌లు, అద్దెదారులు, IDలు.

6. 6

   రేటు మరియు విరామాలను సెట్ చేసి, ఆపై సక్రియం చేయండి

   వెబ్‌సైట్ వార్మర్‌ల మాదిరిగానే అదే ఆలోచన: మీ కాష్ TTLని అధిగమించడానికి తగినంత వెచ్చగా ఉంటుంది, బాధించకుండా నెమ్మదిగా సరిపోతుంది.

ముగింపు బిందువులు#

వార్మర్‌లోని ప్రతి ముగింపు స్థానం స్వతంత్రంగా కాన్ఫిగర్ చేయబడింది:

లేబుల్

ఐచ్ఛికంగా మానవులు చదవగలిగే పేరు, కాబట్టి ఎండ్ పాయింట్‌ల యొక్క సుదీర్ఘ జాబితా చదవగలిగేలా ఉంటుంది.

WordPress

ధృవీకరించబడిన హోస్ట్ పేరుపై పూర్తి ముగింపు బిందువు చిరునామా. PATH డైమెన్షన్‌తో జత చేసినప్పుడు {id} లేదా :id వంటి పాత్ ప్లేస్‌హోల్డర్‌లు ఉండవచ్చు.

పద్ధతి

మీ ప్లాన్‌పై ఆధారపడి GET, POST మరియు ఇతరులు. ప్లాన్‌లు సాధారణంగా GET మరియు HEADని డిఫాల్ట్‌గా అనుమతిస్తాయి, అధిక శ్రేణుల్లో మరిన్ని పద్ధతులతో.

ప్రోటోకాల్

REST లేదా GRAPHQL. GraphQLని ఎంచుకోవడం ఆపరేషన్ మరియు ప్రశ్న ఫీల్డ్‌లను వెల్లడిస్తుంది.

శరీర టెంప్లేట్‌ను అభ్యర్థించండి

పంపడానికి శరీరం, ఒకటి తీసుకువెళ్లే పద్ధతుల కోసం. API అభ్యర్థన శరీర హక్కు అవసరం.

WordPress

అభ్యర్థన అంశం యొక్క కంటెంట్ రకం, సాధారణంగా application/json.

నిస్సత్తువ

ఎండ్‌పాయింట్‌ని రెండుసార్లు కాల్ చేయడానికి సురక్షితమైనదిగా గుర్తుపెట్టి, మెరుగుదలని కొలిచే చల్లని/వెచ్చని డబుల్ ఫెచ్‌ని ఎనేబుల్ చేస్తుంది. వాస్తవానికి రెండుసార్లు కాల్ చేసినప్పుడు మాత్రమే దాన్ని ప్రారంభించండి ఎటువంటి దుష్ప్రభావాలు లేవు.

ప్రారంభించబడింది

ఈ నిర్దిష్ట ముగింపు పాయింట్ పరుగులలో చేర్చబడిందా. ఒక ఎండ్‌పాయింట్‌ను తొలగించకుండా తాత్కాలికంగా నిలిపివేయడం కోసం ఇది ఉపయోగపడుతుంది.

కాన్ఫిగర్ మాత్రికలు#

చాలా APIలు వేరియంట్‌లను కలిగి ఉంటాయి: ఒక్కో లొకేల్‌కి, అద్దెదారుకు, కరెన్సీకి లేదా ఒక్కో IDకి ఒకే ముగింపు స్థానం అని పిలుస్తారు. ప్రతిదానికీ వార్మర్‌ను సృష్టించడం అనేది నిర్వహించలేనిది.

ఒక config matrix దీనిని పరిష్కరిస్తుంది. మీరు బహుళ విలువలతో కొలతలు నిర్వచిస్తారు మరియు Cache Rocket పూర్తి కార్టెసియన్ ఉత్పత్తిని వ్యక్తిగత వెచ్చని అభ్యర్థనలుగా విస్తరిస్తుంది.

ఒక పని ఉదాహరణ

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

మీరు ప్లాన్ గరిష్ట స్థాయిని మించి ఉంటే, వార్మర్ సేవ్ చేయదు. విలువలను తగ్గించండి, అనేక వార్మర్‌లలో విభజించండి లేదా అప్‌గ్రేడ్ చేయండి.

ప్రమాణీకరణ#

గ్లోబల్ అభ్యర్థన శీర్షికలు మరియు కుకీలు వార్మర్ ఉత్పత్తి చేసే ప్రతి రూపాంతరానికి వర్తింపజేయబడతాయి. ఇక్కడే Authorization హెడర్ లేదా సెషన్ కుక్కీ వెళ్తుంది.

Authorization: Bearer YOUR_LONG_LIVED_TOKEN
X-Api-Key: YOUR_API_KEY

టోకెన్ల గడువు ముగుస్తుంది. API వార్మర్ అకస్మాత్తుగా 401ని తిరిగి ఇవ్వడం ప్రారంభిస్తే, హార్డ్-కోడెడ్ టోకెన్‌ని తనిఖీ చేయడం మొదటి విషయం.

WordPress#

GraphQLకి దాని స్వంత చికిత్స అవసరం ఎందుకంటే పనితీరు నిర్దిష్ట ఆపరేషన్‌పై ఆధారపడి ఉంటుంది, ఎండ్‌పాయింట్ మార్గంపై కాదు. ఒకసారి /graphql నొక్కితే మీకు ఏమీ చెప్పదు; మీ మూడు భారీ ప్రశ్నలను వేడెక్కించడం మీకు ప్రతిదీ చెబుతుంది.

ముగింపు పాయింట్ యొక్క ప్రోటోకాల్ని GraphQLకి సెట్ చేసి, ఆపై సరఫరా చేయండి:

• GraphQL ఆపరేషన్ — ఇది query లేదా mutation అయినా. వేడెక్కుతున్న ఉత్పరివర్తనలు దాదాపు ఎప్పుడూ తగినవి కావు.
• GraphQL ప్రశ్న — పంపవలసిన ఆపరేషన్ పత్రం.
• వేరియబుల్స్ — రిక్వెస్ట్ బాడీ టెంప్లేట్ ద్వారా లేదా అనేక వేరియబుల్ సెట్‌లను వార్మ్ చేయడానికి మ్యాట్రిక్స్ డైమెన్షన్ విలువల ద్వారా వాటిని సరఫరా చేయండి.

OpenAPI దిగుమతి#

మద్దతు ఉన్న ప్లాన్‌లలో మీరు వాటిని టైప్ చేయడానికి బదులుగా OpenAPI 3 స్పెసిఫికేషన్ నుండి నేరుగా ఎండ్‌పాయింట్‌లను దిగుమతి చేసుకోవచ్చు. JSON లేదా YAML స్పెక్ యొక్క URLని అతికించి, దిగుమతిని క్లిక్ చేయండి; కనుగొనబడిన ముగింపు బిందువులు వెచ్చగా జోడించబడతాయి, కత్తిరించడానికి మరియు సర్దుబాటు చేయడానికి సిద్ధంగా ఉన్నాయి.

పరిమితులు మరియు షెడ్యూల్#

నిమిషానికి గరిష్టంగా వేడెక్కుతుంది

ఈ API వార్మర్ కోసం రేట్ సీలింగ్, వెబ్‌సైట్ వార్మర్‌లో నిమిషానికి గరిష్టంగా URLsకి సమానం.

అభ్యర్థన గడువు ముగిసింది

వదులుకోవడానికి ముందు ప్రతిస్పందన కోసం ఎంతసేపు వేచి ఉండాలి.

స్వయంచాలక ప్రారంభ విరామం

కొత్త వెచ్చని పాస్ ఎంత తరచుగా ప్రారంభమవుతుంది, సెకన్లలో.

ఎన్క్యూ విరామం

సైకిల్‌లో రీ-క్యూలో ఉన్న పని యొక్క పేసింగ్.

HTTPSకి తిరిగి వ్రాయండి

http:// ఎండ్‌పాయింట్ URLsని https://కి అప్‌గ్రేడ్ చేయండి.

వెచ్చని షెడ్యూల్

పీక్ మరియు ఆఫ్-పీక్ విండోలు, వెబ్‌సైట్ వార్మర్‌ల మాదిరిగానే JSON ఫార్మాట్. అధునాతన వార్మింగ్ చూడండి.

మీ ప్లాన్ API వార్మర్‌ల సంఖ్య, ఒక్కో వార్మర్‌కు ఎండ్‌పాయింట్‌లు మరియు ఒక్కో వార్మర్‌కు కాంబినేషన్‌ల సంఖ్యను కూడా పరిమితం చేస్తుంది.

సాధారణ సమస్యలు#

ప్రతిదీ 401 లేదా 403ని అందిస్తుంది.

ప్రామాణీకరణ శీర్షిక లేదా కుక్కీ లేదు, తప్పు లేదా గడువు ముగిసింది. దీర్ఘకాలిక టోకెన్‌లు సాధారణ అపరాధి — టోకెన్ ఇప్పటికీ చెల్లుబాటులో ఉందో మరియు తిప్పబడలేదని తనిఖీ చేయండి.

చాలా ఎక్కువ కలయికలను పేర్కొంటూ వార్మర్ సేవ్ చేయదు.

మీ మ్యాట్రిక్స్ ప్లాన్ గరిష్ట స్థాయికి మించి విస్తరిస్తుంది. డైమెన్షన్ విలువలను తగ్గించండి, అనేక వార్మర్‌లలో ఎండ్‌పాయింట్‌లను విభజించండి లేదా అప్‌గ్రేడ్ చేయండి.

నాకు అవసరమైన పద్ధతి డ్రాప్‌డౌన్‌లో లేదు.

ఏ HTTP పద్ధతులు అనుమతించబడతాయో ప్లాన్‌లు నియంత్రిస్తాయి. దిగువ స్థాయిలు సాధారణంగా GET మరియు HEADని మాత్రమే అనుమతిస్తాయి.

వార్మింగ్ శుభ్రంగా నడుస్తుంది కానీ నిజమైన క్లయింట్‌లకు ప్రతిస్పందనలు ఇప్పటికీ నెమ్మదిగా ఉంటాయి.

మీరు బహుశా క్లయింట్‌ల అభ్యర్థన కంటే వేరే కాష్ వేరియంట్‌ని నింపుతున్నారు - సాధారణంగా Authorization హెడర్, కుక్కీ లేదా హెడర్ కారణంగా మీ CDN మారుతూ ఉంటుంది. నిజమైన క్లయింట్ పంపే ఖచ్చితమైన అభ్యర్థనను వార్మర్ పంపే వాటితో సరిపోల్చండి.

సంతకం చేసిన, స్వల్పకాలిక టోకెన్ అవసరమయ్యే ముగింపు బిందువును నేను వేడి చేయవచ్చా?

విశ్వసనీయంగా లేదు, ఎందుకంటే వార్మర్ ఒక పరుగుకు తాజా సంతకాన్ని రూపొందించదు. కాష్ చేయదగిన ప్రమాణీకరించబడని వేరియంట్‌ను బహిర్గతం చేయండి లేదా సురక్షితమైన చోట దీర్ఘకాలిక సేవా టోకెన్‌ను ఉపయోగించండి.