Search events

const FP_SECRET_KEY = process.env.FP_SECRET_KEY!
let cursor: string | undefined

do {
	const query = new URLSearchParams({ externalId: 'user-2077' })
	if (cursor) query.set('cursor', cursor)

	const response = await fetch(`https://api.zeno.id/events?${query}`, {
		headers: { 'Auth-API-Key': FP_SECRET_KEY },
	})

	if (!response.ok) {
		throw new Error((await response.json()).message)
	}

	const page = await response.json()
	handle(page.events)
	cursor = page.cursor
} while (cursor)

let cursor: string | undefined

do {
	const page = await fingerprint.searchEvents({ externalId: 'user-2077', country: ['DE', 'NL'], cursor })
	handle(page.events)
	cursor = page.cursor
} while (cursor)

import os

import requests

session = requests.Session()
session.headers["Auth-API-Key"] = os.environ["FP_SECRET_KEY"]

def search_events(**filters):
    """Every matching event, newest first, page by page."""
    params = dict(filters)
    while True:
        # A list value becomes a repeated parameter: country=DE&country=NL.
        response = session.get("https://api.zeno.id/events", params=params, timeout=10)
        response.raise_for_status()
        page = response.json()
        yield from page["events"]
        if "cursor" not in page:
            return
        params["cursor"] = page["cursor"]

for event in search_events(externalId="user-2077", country=["DE", "NL"]):
    handle(event)

use GuzzleHttp\Psr7\Query;
use Illuminate\Support\Facades\Http;

// Every matching event, newest first, page by page. Query::build repeats a
// list (country=DE&country=NL); http_build_query, and so Http::get($url,
// $array), writes country[0]=DE, which the API refuses.
function searchEvents(array $filters): Generator
{
    do {
        $response = Http::withHeaders(['Auth-API-Key' => config('services.fingerprint.secret_key')])
            ->timeout(10)
            ->get('https://api.zeno.id/events?' . Query::build($filters))
            ->throw();

        yield from $response->json('events');
        $filters['cursor'] = $response->json('cursor');
    } while ($filters['cursor'] !== null);
}

foreach (searchEvents(['externalId' => 'user-2077', 'country' => ['DE', 'NL']]) as $event) {
    handle($event);
}

// url.Values repeats a list: Add twice gives country=DE&country=NL.
query := url.Values{}
query.Set("externalId", "user-2077")
query.Add("country", "DE")
query.Add("country", "NL")

for {
	req, err := http.NewRequestWithContext(ctx, http.MethodGet, "https://api.zeno.id/events?"+query.Encode(), nil)
	if err != nil {
		return err
	}
	req.Header.Set("Auth-API-Key", os.Getenv("FP_SECRET_KEY"))

	res, err := httpClient.Do(req)
	if err != nil {
		return err
	}
	var page struct {
		Events []map[string]any `json:"events"`
		Cursor string           `json:"cursor"`
		Found  int              `json:"found"`
	}
	err = json.NewDecoder(res.Body).Decode(&page)
	res.Body.Close()
	if err != nil {
		return err // check res.StatusCode first in real code
	}

	handle(page.Events)
	if page.Cursor == "" {
		return nil
	}
	query.Set("cursor", page.Cursor)
}