GET /zones/:id

A propos

Cette requête liste les informations relatives à une zone.
Elle permet aussi d'accéder à son tracé.

URL

https://api.solutions-territoire.fr/v0/zones/:id

Informations

Disponibilité 0.6.0
Authentification requise Authorization Code ou Client Credentials
Scope requis Aucun
Formats disponibles JSON & GeoJSON
Code HTTP attendu 200

Réponse

JSON

zone Object Une zone avec toutes ses propriétés étendues.

GeoJSON

La réponse est une feature au format GeoJSON, représentant zone avec toutes ses propriétés étendues.

Exemples

Les exemples ci-dessous utilises la variable $ACCESS_TOKEN décrite dans la section Exemple : authentification en ligne de commande.

Exemple de requête JSON

cURL :

curl -X GET \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.solutions-territoire.fr/v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24

HTTPie :

http -jv GET https://api.solutions-territoire.fr/v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24 \
  Accept:"application/json" \
  Authorization:"Bearer $ACCESS_TOKEN"

Résultat :

GET /v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24 HTTP/1.1
Accept: application/json
Authorization: Bearer dGCMv3RWEcgWjgeKS5D6IUw0gv2VKmaPqJzZg9mM_3A

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "zone": {
    "id":    "b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24",
    "title": "Zone des moulins",
    "url":   "/v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24"
  }
}

Exemple de requête GeoJSON

cURL :

curl -X GET \
  -H "Accept: application/geo+json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.solutions-territoire.fr/v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24

HTTPie :

http -jv GET https://api.solutions-territoire.fr/v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24 \
  Accept:"application/geo+json" \
  Authorization:"Bearer $ACCESS_TOKEN"

Résultat :

GET /v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24 HTTP/1.1
Accept: application/geo+json
Authorization: Bearer dGCMv3RWEcgWjgeKS5D6IUw0gv2VKmaPqJzZg9mM_3A

HTTP/1.1 200 OK
Content-Type: application/geo+json; charset=utf-8

{
  "type":     "FeatureCollection",
  "features": [
    {
      "type":     "Feature",
      "geometry": {
        "type":        "Polygon",
        "coordinates": [
          [
            [ 2.2056555747985844, 48.702021761507254 ],
            [ 2.1997332572937016, 48.700619750456592 ],
            [ 2.2061920166015639, 48.698821153845664 ],
            [ 2.2066426277160653, 48.701101253604171 ],
            [ 2.2056555747985844, 48.702021761507254 ]
          ]
        ]
      },
      "properties": {
        "id":    "b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24",
        "title": "Zone des moulins",
        "url":   "/v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24"
      }
    }
  ]
}