AccueilDocumentation API Rest

PUT tournament/:tournament/competitions/:competition_id

Modifie un match.

URL du service

http://api.tournikoti.com/tournament/:tournament/competitions/:competition_id.format

Paramètres

tournament

requis

Identifiant unique du tournoi sous forme d'une chaîne de caractère basée sur le nom du tournoi.

Exemple de valeur : my-tournament

competition_id

optionnel

Identifiant du match.

Exemple de valeur : 789

group_id

optionnel

Identifiant du groupe de match dans lequel doit se trouver le match.

Exemple de valeur : 654

started_at

optionnel

Date et heure de début du match au format yyyy-mm-dd HH:ii:ss.

Exemple de valeur : 2012-12-01 15:30:00

location

optionnel

Lieu du match.

Exemple de valeur : Terrain B

participants

optionnel

Liste des identifiants des participants séparés par une virgule. Un match peut compter 0...N participants. A noter que l'ordre dans lequel sont envoyés les identifiants sera conservé et utilisé lors de la restitution.

Exemple de valeur : 1234,1237

result

optionnel

Score/performances réalisé(es) durant le match. De 0 à 2 participants, ce paramètre doit être une chaîne de caractère faisant état du score; au delà de 2 participants, ce paramètre doit être un tableau de performances indexées selon l'identifiant des participants

Exemple de valeur pour un match entre 2 participants : 6-2 / 7-6

Exemple de valeur pour un match à 3 participants : {"1234":"4m23s","1324":"4m34s","6541":"4m21s"}

winner

optionnel

Identifiant du participant vainqueur.

Exemple de valeur : 1234

Exemple de requête

PUT http://api.tournikoti.com/tournament/my-tournament/competitions/1235.json
PUT Data winner=1237&result=8-0
{
  "competition":
  {
    "id": 1235,
    "group_id": 5679,
    "started_at": "2012-06-06 08:45:00",
    "location": "Terrain C",
    "participants": [
      {
        "competitor_id": 1234,
        "competitor": {
          "id": 1234,
          "name": "John Smith",
          "tags": [
            { "name": "runner" },
            { "name": "boy" },
            { "name": "adult" }
          ],
          "color": "eb3737",
          "level": 1,
          "lft": 2,
          "rgt": 7,
          "created_at": "2012-03-07 10:38:23",
          "updated_at": "2012-03-07 10:38:23"
        },
        "winner": false,
        "result": null,
        "created_at": "2012-03-07 10:38:23",
        "updated_at": "2012-03-07 10:38:23"
      },
      {
        "competitor_id": 1237,
        "competitor": {
          "id": 1237,
          "name": "Wendy O'Brien",
          "tags": [
            { "name": "runner" },
            { "name": "girl" },
            { "name": "adult" }
          ],
          "color": "53dfd9",
          "level": 1,
          "lft": 8,
          "rgt": 9,
          "created_at": "2012-03-07 10:39:29",
          "updated_at": "2012-03-07 10:40:29"
        },
        "winner": true,
        "result": null,
        "created_at": "2012-03-07 10:38:23",
        "updated_at": "2012-03-07 10:38:23"
      }
    ],
    "result": "8-0",
    "has_result": true,
    "created_at": "2012-03-07 10:38:23",
    "updated_at": "2012-03-07 10:38:23"
  },
  "status": 200,
  "message": "updated"
}

Informations du service

Authentification requise ? Oui
Format de réponse json
Méthode HTTP PUT