AccueilDocumentation API Rest

PUT tournament/:tournament/rankings/:ranking_id/add

Ajoute des points à un classement indépendamment avec ou sans rencontre à l'appuie.

URL du service

http://api.tournikoti.com/tournament/:tournament/rankings/:ranking_id/add.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

ranking_id

requis

Identifiant du classement.

Exemple de valeur : 911

competition_id

optionnel

Id de la compétition qui produit la modification du classement. Si la compétition n'est pas spécifiée, la modification de classement apparaitra comme une modification libre.

Exemple de valeur :1234

participants_delta

requis

La structure est à envoyer sous un format JSON directement dans les données en put.

  • competitor_id : Identifiant du participant.
  • unity_id : Identifiant de l\unité visée.
  • delta : Gain positif ou négatif à imputer au participant pour cette unité.

Exemple de valeur :

  [
    {
      "competitor_id" : 1234,
      "unities": [
	    {
	      "unity_id" : 123,
	      "delta": "5"
	    },
	    {
	      "unity_id" : 456,
	      "delta": "-15"
	    }
	  ]
    },{
      "competitor_id" : 1235,
      "unities": [
	    {
	      "unity_id" : 123,
	      "delta": "-3"
	    },
	    {
	      "unity_id" : 456,
	      "delta": "15"
	    }
	  ]
    }
  ]

Exemple de requête

PUT http://api.tournikoti.com/tournament/my-tournament/rankings/789.json
PUT Data competition_id=123&participants_delta="[{\"competitor_id\":1234,\"unities\":[{\"unity_id\":123,\"delta\": \"5\"},{\"unity_id\":456,\"delta\":\"-15\"}]},{\"competitor_id\": 1235,\"unities\":[{\"unity_id\":123,\"delta\":\"-3\"},{\"unity_id\":456,\"delta\":\"15\"}]}]"
{
  "ranking":
  {
    "id": 1234
    "name": "Classement général",
    "description": NULL,
    "closed_at": NULL,
    "competitors": [
           {
           	   "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"
           },
           {
               "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"
           }
    ],
    "unities": [
      { 
        "name" : "PTS",
        "version" : 5, 
        "competitors_ranking": [
          {
            "competitor_id": 1234,
            "position": 2,
            "total": 8
          },
          {
            "competitor_id": 1235,
            "position": 1,
            "total": 10
          },
          {
            "competitor_id": 1236,
            "position": 3,
            "total": -1
          }
        ],
        "general": true
      },
      { 
        "name" : "BC",
        "version" : 10, 
        "competitors_ranking": [
          {
            "competitor_id": 1234,
            "position": 1,
            "total": 5
          },
          {
            "competitor_id": 1235,
            "position": 3,
            "total": -5
          },
          {
            "competitor_id": 1236,
            "position": 2,
            "total": 4
          }
        ],
        "general": false
      },
    ]
  },
  "status": 200,
  "message": "ok"
}

Informations du service

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