apiIds

Naming items by id in a query (Ids=a,b,c). The ids ride in the URL, so a long list has to be split across requests to keep each request line short. Any lookup by a list of ids goes through here, so they all stay under the same limit.

Members

(static, constant) PER_REQUEST

How many ids one request names. Each costs 35 bytes of URL (32 hex + an encoded comma), so 100 keeps a request near 3.5 KB, well inside common request-line limits.

Default Value
  • 100

Methods

(static) chunks(ids, sizeopt) → {object}

chunks: The ids split into runs of at most size, in order, one request each.

Parameters:
NameTypeAttributesDefaultDescription
idsobject

array of strings

sizeinteger<optional>
apiIds.PER_REQUEST

the most ids in one run (at least 1)

Returns:

array of arrays

Type: 
object