Add documentation for retry configuration in pystac-client and enable them by default

[pv-98]

Please refer the API error issue for the problems faced.

[TomAugspurger]

I wonder if this is the same as custom certificates? Something like

from pystac_client.stac_api_io import StacApiIO
from pystac_client.client import Client
from requests.adapters import HTTPAdapter, Retry

stac_api_io = StacApiIO()
retries = Retry(total=5, backoff_factor=1, status_forcelist=[ 502, 503, 504 ])
stac_api_io.session.mount(
    "http://", HTTPAdapter(max_retries=retries)
)
client = Client.open("https://planetarycomputer.microsoft.com/api/stac/v1", stac_io=stac_api_io)

[gadomski]

Don't see why that wouldn't work, but since we're a network-y library, I think it'd make sense to add retries as a configuration option to StacApiIO. I'm marking this issue as an enhancement to track.

FYI here's the relevant bits of the RetryStacIO in pystac: https://github.com/stac-utils/pystac/blob/e196e50bd23b52169d2f85fcd2d126fc7258684f/pystac/stac_io.py#L439-L444