ਸੀਮਾਵਾਂ ਅਤੇ ਗਲਤੀਆਂ

ਹਰ ਪੰਨੇ ਨੂੰ ਪੜ੍ਹੋ, ਦਰ ਸੀਮਾਵਾਂ ਦਾ ਸਤਿਕਾਰ ਕਰੋ ਅਤੇ ਗਲਤੀਆਂ ਤੋਂ ਸੁਰੱਖਿਅਤ ਢੰਗ ਨਾਲ ਮੁੜ ਪ੍ਰਾਪਤ ਕਰੋ।

1. ਦਰ ਸੀਮਾਵਾਂ

   ਸੀਮਾਵਾਂ ਸੰਰਚਨਾਯੋਗ ਹਨ। GET /v1/operations/capabilities requestsPerMinute ਅਤੇ authenticationRequestsPerMinutePerIp ਦੀ ਰਿਪੋਰਟ ਕਰਦਾ ਹੈ। 429 ਤੋਂ ਬਾਅਦ, ਰੀਟ੍ਰਾਈ-ਆਫਟਰ ਦਾ ਸਨਮਾਨ ਕਰੋ ਅਤੇ ਜੇਕਰ ਥ੍ਰੋਟਲਿੰਗ ਜਾਰੀ ਰਹਿੰਦੀ ਹੈ ਤਾਂ ਹੋਰ ਉਡੀਕ ਕਰੋ। ਬੈਚ ਰੀਡ 100 ਆਈਡੀ ਤੱਕ ਸਵੀਕਾਰ ਕਰਦੇ ਹਨ; ਵਿਅਕਤੀਗਤ ਐਂਡਪੁਆਇੰਟਾਂ ਵਿੱਚ ਛੋਟੇ ਪੇਜ ਜਾਂ ਪੇਲੋਡ ਸੀਮਾਵਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। (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 ਅਤੇ ਬਾਡੀ ਦੀ ਮੁੜ ਵਰਤੋਂ ਕਰੋ।