RemoteGymp · API v1

పరిమితులు మరియు లోపాలు

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

  1. రేట్ పరిమితులు

    పరిమితులను కాన్ఫిగర్ చేయవచ్చు. GET, /v1/operations/capabilities అనేవి requestsPerMinute మరియు authenticationRequestsPerMinutePerIpలను నివేదిస్తాయి. 429 తర్వాత, రీట్రై-ఆఫ్టర్‌ను పాటించండి మరియు థ్రాట్లింగ్ కొనసాగితే ఎక్కువసేపు వేచి ఉండండి. బ్యాచ్ రీడ్‌లు 100 IDల వరకు అంగీకరిస్తాయి; వ్యక్తిగత ఎండ్‌పాయింట్‌లకు చిన్న పేజీ లేదా పేలోడ్ పరిమితులు ఉండవచ్చు. (Retry-After)

  2. ప్రతి పేజీని చదవండి

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

    పేజీల విభజనదీనితో కొనసాగించండిఈ సందర్భంలో ఆపండి
    కర్సర్nextను afterగా పంపండి.తదుపరిది null.
    nextOffsetతో ఆఫ్‌సెట్ చేయండిnextOffsetను offsetగా పంపండి.nextOffset అనేది null.
    hasMoreతో ఆఫ్‌సెట్ చేయండితిరిగి వచ్చిన అంశాల సంఖ్య మేరకు ఆఫ్‌సెట్‌ను పెంచండి.hasMore ఫాల్స్.
    సాఫ్ట్‌వేర్సంఖ్యాత్మక next విలువను afterగా పంపండి; updatedAtUtc మారితే పునఃప్రారంభించండి.తదుపరిది null.
    ఈవెంట్ ఫీడ్nextను afterగా పంపండి.hasMore ఫాల్స్.
  3. లోపాలను నిర్వహించండి

    HTTP స్థితితో పాటు ఎర్రర్ కోడ్‌ను కూడా చదవండి. ప్రతిస్పందనలో requestId ఉంటే, సపోర్ట్‌ను సంప్రదించేటప్పుడు దానిని ఉదహరించండి.

    HTTP స్థితిఏం చేయాలి
    400అభ్యర్థనను సరిచేయండి.
    401ఆధారాలను తనిఖీ చేయండి లేదా కొత్త యాక్సెస్ టోకెన్‌ను పొందండి.
    403పరిధి, అనుమతులు మరియు యాక్సెస్ ప్రారంభించబడిందో లేదో తనిఖీ చేయండి.
    404ఆ వనరు అందుబాటులో లేకపోవచ్చు లేదా మీ పరిధికి వెలుపల ఉండవచ్చు.
    409నిర్ణయం తీసుకునే ముందు ఎర్రర్ కోడ్ మరియు ప్రస్తుత స్థితిని చదవండి.
    410స్నాప్‌షాట్ లేదా ఈవెంట్ కర్సర్ గడువు ముగిసింది. కొత్త బేస్‌లైన్‌ను ప్రారంభించండి.
  4. ఒక రైట్ టైమ్ అవుట్ అయితే

    టైమ్ అవుట్ లేదా 503 అనేది చర్య విఫలమైందని నిరూపించదు. ఆపరేషన్ రసీదులను తిరిగి ఇచ్చే రైట్‌ల కోసం, మళ్లీ ప్రయత్నించే ముందు GET /v1/operations/by-key?idempotencyKey={key} ను చూడండి. నిర్వహణ సృష్టి కోసం, అసలైన Idempotency-Key మరియు బాడీని తిరిగి ఉపయోగించండి.

API సూచిక →

కంటెంట్ రివిజన్ 3f225a253 · OpenAPI SHA-256: b12c42306a89