Method GET

scripts/affiliate_server.py:531–628

GET endpoint looking up ISBNs and B* ASINs via the affiliate server. URL Parameters: - high_priority='true' or 'false': whether to wait and return result. - stage_import='true' or 'false': whether to stage result for import. By default this is

(self, identifier: str)

class Submit:
    def GET(self, identifier: str) -> str:
        """
        GET endpoint looking up ISBNs and B* ASINs via the affiliate server.

        URL Parameters:
            - high_priority='true' or 'false': whether to wait and return result.
            - stage_import='true' or 'false': whether to stage result for import.
              By default this is 'true'. Setting this to 'false' is useful when you
              want to return AMZ metadata but don't want to import; therefore
              high_priority=true must also be 'true', or this returns nothing and
              stages nothing (unless the result is cached).

        If `identifier` is in memcache, then return the `hit` (which is marshalled
        into a format appropriate for import on Open Library if `?high_priority=true`).

        By default `stage_import=true`, and results will be staged for import if they have
        requisite fields. Disable staging with `stage_import=false`.

        If no hit, then queue the identifier for look up and either attempt to return
        a promise as `submitted`, or if `?high_priority=true`, return marshalled data
        from the cache.

        `Priority.HIGH` is set when `?high_priority=true` and is the highest priority.
        It is used when the caller is waiting for a response with the AMZ data, if
        available. See `PrioritizedIdentifier` for more on prioritization.

        NOTE: For this API, "ASINs" are ISBN 10s when valid ISBN 10s, and otherwise
        they are Amazon-specific identifiers starting with "B".
        """
        # cache could be None if reached before initialized (mypy)
        if not web.amazon_api:
            return json.dumps({"error": "not_configured"})

        # Handle URL query parameters.
        input = web.input(high_priority=False, stage_import=True)
        priority = Priority.HIGH if input.get("high_priority") == "true" else Priority.LOW
        stage_import = input.get("stage_import") != "false"

        b_asin, isbn_10, isbn_13 = normalize_identifier(identifier)
        key = isbn_10 or b_asin

        # For ISBN 13, conditionally go straight to Google Books.
        if not key and isbn_13 and priority == Priority.HIGH and stage_import:
            return json.dumps({"status": "success"}) if stage_from_google_books(isbn=isbn_13) else json.dumps({"status": "not found"})

        if not (key := isbn_10 or b_asin):
            return json.dumps({"error": "rejected_isbn", "identifier": identifier})

        # Cache lookup by isbn_13 or b_asin. If there's a hit return the product to
        # the caller.
        if product := cache.memcache_cache.get(f"amazon_product_{isbn_13 or b_asin}"):
            return json.dumps(
                {
                    "status": "success",
                    "hit": clean_amazon_metadata_for_load(product),
                }
            )