Exemples d'utilisation de l'API

Chaque exemple montre le code PHP + le resultat en direct depuis https://bokonzi.com/api

1. Recuperer un athlete par son ID

$json = file_get_contents("https://bokonzi.com/api/athlete.php?id=26134");
$data = json_decode($json, true);

echo $data['identite']['nom_complet'];
echo $data['identite']['sexe'];
echo $data['identite']['categorie'];

Resultat :

Nom : Elodie MATHELIN
Sexe : F
Categorie : -
Naissance : 01/01/1986
Nationalite : FRA
Licence : 245549

2. Lister les records d'un athlete

$json = file_get_contents("https://bokonzi.com/api/athlete.php?id=26134");
$data = json_decode($json, true);

foreach ($data['records'] as $r) {
    echo $r['epreuve'] . " : " . $r['performance_brut'] . "\n";
}

Resultat :

Epreuve	Performance	Date	Lieu	Club
800m	2'27''32	26/06/2004	Arles	Ac Perpignan
10 Km Route	52'27''	30/11/-0001	Leucate	NL la veille de la compétition

3. Lister les clubs d'un athlete

$json = file_get_contents("https://bokonzi.com/api/athlete.php?id=26134");
$data = json_decode($json, true);

foreach ($data['clubs'] as $c) {
    echo $c['nom_club'] . " (" . $c['annee_debut'] . " - " . $c['annee_fin'] . ")\n";
}

Resultat :

NL la veille de la compétition (2005 - 2006)
Ac Perpignan (2004 - 2004)

4. Lister les medailles

foreach ($data['medailles'] as $m) {
    echo $m['type'] . " | " . $m['epreuve'] . " | " . $m['competition'] . "\n";
}

Resultat :

Aucune medaille

5. Lister les resultats

foreach ($data['resultats'] as $r) {
    echo dateFR($r['date']) . " | " . $r['epreuve'] . " | " . $r['performance_brut'] . " | place " . $r['place'] . "\n";
}

Resultat (20 premiers) :

Date	Epreuve	Perf	Vent	Tour	Place	Niveau	Lieu
16/08/2013	7km	34'47''		H.Stade	171		Torreilles (Village)

6. Lister les progressions

foreach ($data['progressions'] as $p) {
    echo $p['annee'] . " | " . $p['epreuve'] . " | " . $p['performance_brut'] . "\n";
}

Resultat :

Annee	Epreuve	Performance	Date	Lieu	Club
2006	10 Km Route	1h10'53''	26/03/2006	Leucate	NL la veille de la compétition
2005	10 Km Route	52'27''	30/11/-0001	Leucate	NL la veille de la compétition
2004	800m	2'27''32	26/06/2004	Arles	Ac Perpignan

7. Lister les selections

foreach ($data['selections'] as $s) {
    echo $s['type'] . " | " . $s['competition'] . " | " . $s['epreuve'] . "\n";
}

Resultat :

Aucune selection

8. Lister les niveaux + performances

foreach ($data['niveaux'] as $n) {
    echo $n['annee'] . " | " . $n['code_niveau'] . " | " . $n['points_niveau'] . " pts\n";
    foreach ($n['performances'] as $perf) {
        echo "   " . $perf['epreuve'] . " : " . $perf['performance_brut'] . "\n";
    }
}

Resultat :

2004 — R2 6 pts | Ac Perpignan

Epreuve	Performance	Code
800m	2'29''41	R2
800m	2'27''32	R1

9. Rechercher des athletes par nom

$json = file_get_contents("https://bokonzi.com/api/search.php?nom=dupont&sexe=M&limit=5");
$data = json_decode($json, true);

echo "Total : " . $data['total'] . " resultats\n";
foreach ($data['athletes'] as $a) {
    echo $a['nom_complet'] . " | " . $a['categorie'] . " | " . $a['nationalite'] . "\n";
}

Resultat :

Total : 91 resultats (5 premiers affiches)

ID	Nom	Naissance	Cat	Sexe	NAT
548525	Adrien DUPONT	01/01/1993	-	M	FRA
2643370	Alexandre DUPONT	01/01/2002	-	M	FRA
1624458	Alexis DUPONT	01/01/2001	-	M	FRA
1331685	Angelo DUPONT	01/01/1997	-	M	FRA
59465	Anthony DUPONT	01/01/1991	-	M	FRA

10. Statistiques globales

$json = file_get_contents("https://bokonzi.com/api/stats.php");
$data = json_decode($json, true);

echo "Athletes : " . $data['comptages']['athletes']['count'] . "\n";
echo "Clubs : " . $data['comptages']['clubs']['count'] . "\n";
echo "Records : " . $data['comptages']['athlete_records']['count'] . "\n";

Resultat :

Total athletes : 330 345
Total affiliations clubs : 553 215
Total medailles : 1 896
Total selections : 0
Total progressions : 8 182 605
Total records : 2 643 020
Total podiums : 1 070 038
Total resultats : 1 704 954
Total niveaux : 1 356 784
Total niveaux performances : 1 973 814
Clubs uniques : 11 182
Epreuves uniques : 46 047
Villes uniques : 18 471
Competitions uniques : 20
Nationalites uniques : 165

11. Lister les podiums

foreach ($data['podiums'] as $p) {
    echo $p['annee'] . " | " . $p['place'] . " | " . $p['epreuve'] . " | " . $p['performance_brut'] . "\n";
}

Resultat :

Annee	Niveau	Place	Epreuve	Performance	Lieu
2003	Départemental	Championne JUF - 066	Juniors filles	20'49''	Argeles Sur Mer