ਨਤੀਜਿਆਂ ਨੂੰ ਪੰਨਿਆਂ ਵਿੱਚ ਵੰਡਣਾ
ਲੰਬੀਆਂ ਹੋ ਸਕਣ ਵਾਲੀਆਂ ਸੂਚੀਆਂ ਇੱਕ ਵਾਰ ਵਿੱਚ ਇੱਕ ਪੰਨੇ ਵਜੋਂ ਮਿਲਦੀਆਂ ਹਨ, ਸਭ ਤੋਂ ਨਵੀਆਂ ਆਈਟਮਾਂ ਪਹਿਲਾਂ: ਹਰ ਪੰਨਾ ਦੱਸਦਾ ਹੈ ਕਿ ਅਗਲਾ ਪੰਨਾ ਕਿੱਥੋਂ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ। ਹੋਰ ਸੂਚੀਆਂ ਪੂਰੀਆਂ ਮਿਲਦੀਆਂ ਹਨ।
ਕਰਸਰ ਅਧਾਰਿਤ ਪੰਨੇ
ਸੁਨੇਹੇ, ਈਮੇਲ ਟੈਂਪਲੇਟ ਅਤੇ ਅਸਫਲ 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 ਟੈਂਪਲੇਟ ਪੰਨਿਆਂ ਵਿੱਚ ਵੰਡੇ ਬਿਨਾਂ ਪੂਰੇ ਮਿਲਦੇ ਹਨ।