Oblic

ಫಲಿತಾಂಶಗಳನ್ನು ಪುಟಗಳಾಗಿ ವಿಂಗಡಿಸುವುದು

ಉದ್ದವಾಗಬಹುದಾದ ಪಟ್ಟಿಗಳು ಒಂದು ಸಲಕ್ಕೆ ಒಂದು ಪುಟವಾಗಿ, ಹೊಸ ಅಂಶಗಳು ಮೊದಲು ಬರುವಂತೆ ಮರಳುತ್ತವೆ: ಪ್ರತಿ ಪುಟವು ಮುಂದಿನ ಪುಟ ಎಲ್ಲಿ ಆರಂಭವಾಗುತ್ತದೆ ಎಂಬುದನ್ನು ಸೂಚಿಸುತ್ತದೆ. ಇತರ ಪಟ್ಟಿಗಳು ಸಂಪೂರ್ಣವಾಗಿ ಮರಳುತ್ತವೆ.

ಕರ್ಸರ್ ಆಧಾರಿತ ಪುಟಗಳು

ಸಂದೇಶಗಳು, ಇಮೇಲ್ ಟೆಂಪ್ಲೇಟ್‌ಗಳು ಮತ್ತು ವಿಫಲ webhook ವಿತರಣೆಗಳು ಕರ್ಸರ್ ಮೂಲಕ ಪುಟಗಳಾಗಿ ವಿಂಗಡಿಸಲ್ಪಡುತ್ತವೆ:

  • ಹೆಸರು
    limit
    ಟೈಪ್ ಮಾಡಿ
    integer
    ವಿವರಣೆ

    ಒಂದು ಪುಟದಲ್ಲಿರುವ ಅಂಶಗಳ ಸಂಖ್ಯೆ, 1 ರಿಂದ 100; ಪೂರ್ವನಿಯೋಜಿತ ಸಂಖ್ಯೆ 25.

  • ಹೆಸರು
    cursor
    ಟೈಪ್ ಮಾಡಿ
    string
    ವಿವರಣೆ

    ಮೊದಲ ಪುಟಕ್ಕಾಗಿ ಇದನ್ನು ಕಳುಹಿಸಬೇಡಿ; ನಂತರ ಹಿಂದಿನ ಪುಟದ next ಮೌಲ್ಯವನ್ನು ಬಂದಂತೆಯೇ ಕಳುಹಿಸಿ.

ಪ್ರತಿ ಪುಟವು ಅದರ ಅಂಶಗಳು ಮತ್ತು next ಅನ್ನು ಹೊಂದಿರುತ್ತದೆ; ಕೊನೆಯ ಪುಟದಲ್ಲಿ ಅದು null ಆಗಿರುತ್ತದೆ. ಕರ್ಸರ್ ಅನ್ನು ಅರ್ಥೈಸದೆ ಬಳಸಬೇಕಾದ ಮೌಲ್ಯವಾಗಿ ಪರಿಗಣಿಸಿ ಮತ್ತು ಪ್ರತಿ ಪಟ್ಟಿಗೆ ಅದರದೇ ಕರ್ಸರ್ ಅನ್ನು ಮಾತ್ರ ಕಳುಹಿಸಿ: ಪಟ್ಟಿಗಳ ನಡುವೆ ಸ್ವರೂಪಗಳು ಭಿನ್ನವಾಗಿರುತ್ತವೆ ಮತ್ತು ಕರ್ಸರ್ ಅಲ್ಲದ ಮೌಲ್ಯವನ್ನು 400 BAD_REQUEST ಮೂಲಕ ನಿರಾಕರಿಸಲಾಗುತ್ತದೆ.

ಎಲ್ಲ ಸಂದೇಶಗಳು, ಒಂದು ಸಲಕ್ಕೆ ಒಂದು ಪುಟ

cursor=''
while :; do
  page=$(curl -sG https://api.oblic.app/external/v1/messages \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d limit=100 ${cursor:+-d cursor="$cursor"})
  echo "$page" | jq -c '.data.messages[]'
  cursor=$(echo "$page" | jq -r '.data.next // empty')
  [ -z "$cursor" ] && break
done

ಕರ್ಸರ್ ಅದರ ಪುಟದ ಕೊನೆಯ ಅಂಶವನ್ನು ಸೂಚಿಸುತ್ತದೆ. ಆದ್ದರಿಂದ ಪುಟಗಳನ್ನು ಓದುವಾಗ ಸೇರಿಸಲಾದ ಅಂಶಗಳು ನಂತರದ ಪುಟಗಳನ್ನು ಸರಿಸುವುದಿಲ್ಲ: ಹೊಸ ಅಂಶಗಳು ಆರಂಭದಲ್ಲಿ ಬರುತ್ತವೆ ಮತ್ತು ಮೊದಲ ಪುಟದಿಂದ ಮತ್ತೆ ಓದಿದಾಗ ಸಿಗುತ್ತವೆ.

ಸಂಪರ್ಕ ಪಟ್ಟಿಗಳು

ಸಂಪರ್ಕ ಪಟ್ಟಿಗಳು ಪಥದಲ್ಲಿನ ಆಫ್‌ಸೆಟ್ ಮೂಲಕ ಪುಟಗಳಾಗಿ ವಿಂಗಡಿಸಲ್ಪಡುತ್ತವೆ: /external/contact-list/v1/{nextIndex}/{limit}. 0 ರಿಂದ ಆರಂಭಿಸಿ; ಪ್ರತಿ ಪುಟವು moreIndicator ನಲ್ಲಿ ಇನ್ನೂ ಫಲಿತಾಂಶಗಳಿವೆಯೇ (Y ಅಥವಾ N) ಎಂಬುದನ್ನು ಮತ್ತು nextIndex ನಲ್ಲಿ ಮುಂದಿನ ಪುಟ ಎಲ್ಲಿ ಆರಂಭವಾಗುತ್ತದೆ ಎಂಬುದನ್ನು ಸೂಚಿಸುತ್ತದೆ.

ಸಂಪೂರ್ಣ ಪಟ್ಟಿಗಳು

ಕಳುಹಿಸುವವರ ಗುರುತುಗಳು, webhook ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು, ಉಪಖಾತೆಗಳು, SMS ಹೆಡರ್‌ಗಳು ಮತ್ತು ಟೆಂಪ್ಲೇಟ್‌ಗಳು ಹಾಗೂ WhatsApp ಟೆಂಪ್ಲೇಟ್‌ಗಳು ಪುಟಗಳಾಗಿ ವಿಂಗಡಿಸದೆ ಸಂಪೂರ್ಣವಾಗಿ ಮರಳುತ್ತವೆ.

ಈ ಪುಟವು ಸಹಾಯಕವಾಗಿದೆಯೇ?