Aller au contenu

/v1/contests/{id}/actions

GET
/v1/contests/{id}/actions
curl --request GET \
--url 'https://example.com/v1/contests/54732603/actions?lang=ar'
id
required

Contest

string
>= 1 characters /^\d+$/

Example

54732603

Contest

lang

Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.

string
Allowed values: ar da de en es fa fi fr it ja ko nl no pl pt ro ru sv th tr zh

Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.

Actions du match dans l’ordre du jeu : buts (buteur, passeur), cartons, remplacements, tirs, fautes, VAR

Media typeapplication/json
object
data
required
object
contest
required

Un contest, en référence légère : sa fiche est /v1/contests/{id}

object
id
required

Identifiant opaque d’un contest (match, course, épreuve)

string
>= 1 characters
startsAt
required

Instant ISO 8601 en UTC (2026-10-10T13:30:00.000Z)

string format: date-time
nullable
actions
required

Actions dans l’ordre du match ; vide si le match n’est pas couvert

Array<object>

Une action de match : but, carton, remplacement, tir, faute…

object
id
required

Identifiant opaque d’une action de match (but, carton…)

string
>= 1 characters
type
required

Nature exacte d’une action (« but sur penalty », « deuxième carton jaune »…) ; label en donne le libellé traduit. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
family
required

Famille d’une action, pour filtrer les temps forts : goal réunit tous les buts marqués (de la tête, sur penalty…), hors buts contre son camp (own-goal) et buts refusés (disallowed-goal). Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
label
required

Libellé de type (« But sur penalty »)

string
nullable
minute
required

Minute de jeu. Le temps additionnel la prolonge au-delà de la fin de la période : 48 en « 1ère mi-temps » se lit 45+3. Un tir au but porte son rang dans la séance (1, 2, 3…)

number
nullable
period
required

Période de jeu (« 1ère mi-temps », « Tirs au but »…)

string
nullable
side
required
Any of:

Camp d’un duel : à domicile ou à l’extérieur

string
Allowed values: home away
person
required
Any of:

Une personne : athlète, joueur, arbitre

object
id
required

Identifiant opaque d’une personne (athlète, arbitre)

string
>= 1 characters
name
required
string
nullable
photo
required
Any of:

Portrait d’une personne, en JPEG au format 5:7 : small en 50 × 70 px (liste, composition), large en 100 × 141 px (fiche). Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez un repli (silhouette neutre)

object
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
relatedPerson
required
Any of:

Une personne : athlète, joueur, arbitre

object
id
required

Identifiant opaque d’une personne (athlète, arbitre)

string
>= 1 characters
name
required
string
nullable
photo
required
Any of:

Portrait d’une personne, en JPEG au format 5:7 : small en 50 × 70 px (liste, composition), large en 100 × 141 px (fiche). Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez un repli (silhouette neutre)

object
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
occurredAt
required

Heure de l’action, si connue

string format: date-time
nullable
meta
required

Méta d’une réponse /v1 ou d’un module

object
generatedAt
required

Date de génération de la réponse

string format: date-time
version
required

Version du contrat de la réponse : v1 pour une ressource /v1, celle du module pour un module (/modules/<nom>/v<n> → v<n>)

string
Allowed values: v1
lang
required

Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.

string
Allowed values: ar da de en es fa fi fr it ja ko nl no pl pt ro ru sv th tr zh
links
required
object
self
required

Chemin de la ressource, paramètres triés

string

Example

{
"data": {
"actions": [
{
"side": "home"
}
]
},
"meta": {
"version": "v1",
"lang": "ar"
}
}

Contenu inchangé depuis l’ETag envoyé en If-None-Match

Paramètre invalide ou inconnu

Media typeapplication/problem+json

Erreur au format application/problem+json (RFC 9457)

object
type
required
string
title
required
string
status
required
integer
code
required

Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
detail

Explication propre à cette requête

string
requestId

Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support

string

Example generated

{
"type": "example",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"requestId": "example"
}

Contest inconnu

Media typeapplication/problem+json

Erreur au format application/problem+json (RFC 9457)

object
type
required
string
title
required
string
status
required
integer
code
required

Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
detail

Explication propre à cette requête

string
requestId

Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support

string

Example generated

{
"type": "example",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"requestId": "example"
}