Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

ETL: batch geocoding pipeline with rate limiting and resume support

Ouverte
#26 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
25/100
Type d'issue
Fonctionnalité
Clarté
À clarifier
Activité
Calme
Stack technique
php

Piste de recherche

Start by reading the SDK’s HttpTransportInterface and how Client accepts transports; those entry points are named in the issue, but no file paths or tests are provided. The scope depends on deciding whether retries belong in the core or an optional package and how checkpoint state should be stored. Done would require a settled design for retry/backoff and resume behavior across rate-limit signals.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

enhancement question

Problem

When geocoding large address lists (10k+ records), the API rate limits kick in. There is currently no built-in mechanism in the SDK to handle this gracefully.

Typical pattern people try

$client = new Client($token);
foreach ($addresses as $addr) {
    $result = $client->get('https://geocoding.openapi.com/geocode', ['address' => $addr]);
    // if rate limit hit (429), this throws immediately and the whole batch is lost
}

What would help

A retry/backoff decorator on top of HttpTransportInterface:

use Openapi\Transports\RetryTransport;

$client = new Client($token, new RetryTransport(
    maxRetries: 3,
    backoffMs: 500,
    retryOn: [429, 503]
));

And a checkpoint mechanism to resume from the last successful record.

Open questions

  • Should RetryTransport be part of the core SDK or a separate optional package?
  • Should the checkpoint state be file-based, Redis-based, or left to the consumer?
  • Is 429 the only rate-limit signal used across all Openapi endpoints?
Langage dominant
PHP
Étoiles
20
Forks
3
Métriques de merge des PR
Aucune PR mergée en 30 j

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de openapi/openapi-php-sdk

Toutes les issues de openapi/openapi-php-sdk

Issues similaires

Plus d'issues PHP

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.