RemoteGymp · API v1

வரம்புகள் மற்றும் பிழைகள்

ஒவ்வொரு பக்கத்தையும் படிக்கவும், விகித வரம்புகளை மதிக்கவும் மற்றும் பிழைகளிலிருந்து பாதுகாப்பாக மீட்கவும்.

  1. விகித வரம்புகள்

    வரம்புகள் உள்ளமைக்கக்கூடியவை. GET மற்றும் /v1/operations/capabilities ஆகியவை requestsPerMinute மற்றும் authenticationRequestsPerMinutePerIp-ஐப் புகாரளிக்கின்றன. 429-க்குப் பிறகு, மீண்டும் முயற்சி செய்-பின் (Retry-After) என்பதை மதிக்கவும், மேலும் வேகக் கட்டுப்பாடு (throttling) தொடர்ந்தால் அதிக நேரம் காத்திருக்கவும். தொகுதி வாசிப்புகள் (Batch reads) 100 ஐடிகள் வரை ஏற்கும்; தனிப்பட்ட முனையங்களுக்கு (endpoints) சிறிய பக்க அல்லது பேலோட் வரம்புகள் இருக்கலாம்.

  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