Чӣ гуна моделро барои интизорӣ (Waiter) барои API амалӣ кардан мумкин аст?

Иҷрои намунаи Waiter барои API дар дохили гардиши такрорӣ барои санҷидани ҳолати манбаъ ё иҷрои амалия то расидани шарти интизорӣ ё тамом шудани вақти муайяншуда мебошад.

Қадамҳои асосӣ:

1. Таъйин кардани шарти санҷишӣ: равшан фаҳмед, ки кадом ҳолати API ё манбаъ "омод" ҳисобида мешавад (масалан, тағйири ҳолати дархост, пайдо шудани навтарин сабт, баргардонидани маълумоти интизорӣ).
2. Танзим кардани механизми санҷиш: муайян кунед, ки чӣ гуна ҳолати санҷишӣ иҷро мешавад. Ин метавонад такрори дархост ба ҳамон нуқтаи охирӣ, дархост ба нуқтаи махсуси ҳолат ё санҷиши мазмуни ҷавоб бошад.
3. Танзим кардани параметрҳои интизорӣ: вақти максималии интизорӣ (тайм-аути) ва интервал байни санҷишҳоро муқаррар кунед.
4. Иҷрои гардиш: як гардиш созед, ки ҳолати санҷишро бо интервал муайян мекунад.
5. Таҳлили шартҳои баромад:
   • Баромад дар расидани шарти интизорӣ.
   • Баромад дар тамом шудани тайм-аути, бо истисно ё хато.
6. Таҳлили хатоҳо дар вақти санҷиш: пешбинӣ кунед, ки чӣ гуна хатоҳои эҳтимолиро дар дохили гардиш коркард кунед (масалан, дастрас набудани муваққатии API).

Намунаи псевдокод:

# wait_for_resource_ready(api_endpoint, expected_condition, timeout_seconds, interval_seconds)

start_time = current_time
while current_time - start_time < timeout_seconds:
    response = make_api_request(api_endpoint) # иҷрои дархост ба API

    if check_condition(response, expected_condition): # санҷиши шарти омодагӣ
        return True # шарти интизорӣ иҷро шуд

    sleep(interval_seconds) # интизорӣ пеш аз санҷиши нав
    current_time = current_time # навсозии вақти ҳозира

raise TimeoutError("Манбаъ дар вақти муайяншуда омода нашуд") # тамом шудани вақти муайян

# check_condition(response, expected_condition):
# Логикаи санҷиши шарти омодагӣ дар асоси ҷавоби API
# Масалан, return response['status'] == 'ready'

Намунаи Python бо истифода аз китобхонаи requests:

import requests
import time

def wait_for_status(url, expected_status, timeout=60, interval=5):
    """
    интизор мешавад, то ки нуқтаи охирӣ як статус муайянро баргардонад.
    """
    start_time = time.time()

    while time.time() - start_time < timeout:
        try:
            response = requests.get(url)
            if response.status_code == expected_status:
                print(f"[{time.strftime('%H:%M:%S')}] Статус {expected_status} гирифта шуд.")
                return True
        except requests.exceptions.RequestException as e:
            print(f"[{time.strftime('%H:%M:%S')}] Хатои дархост: {e}. Такрор дар {interval} сония.")

        time.sleep(interval)

    raise TimeoutError(f"Намудани статус {expected_status} дар {timeout} сония.")

# Мисоли истифода
# try:
#     wait_for_status("http://api.example.com/status", 200)
# except TimeoutError as e:
#     print(e)

Интихоби татбиқи мушаххас аз хусусиятҳои API ва талаботи санҷиш вобаста аст. Муҳим аст, ки дар танзимоти тайм-аутиҳо ва интервалҳо чандирӣ таъмин карда шавад, инчунин паёмҳои иттилоотӣ дар бораи тамом шудани вақти муайян.