Menu

Accueil > Données ouvertes > Services ouverts > Requêtes ouvertes

Requêtes ouvertes

Description technique – Requêtes* ouvertes

*Le terme « requêtes » dans la section suivante fait référence à une demande citoyenne pour un service municipal.

L’approche REST offre deux types de méthodes : le GET pour la lecture et le POST pour l’écriture. La norme GeoReportv2 offre les méthodes suivantes:

Définition des requêtes

  1. GET Service List

    Permet d’obtenir la liste des types de requêtes permises par le système.
    La liste des cinq (5) types de requête offerts par la Ville de Québec est :
  2. GET Service Definition

    Si un type de requête nécessite des champs spécifiques, cette méthode permet d’obtenir la liste des champs.

    C’est le cas, par exemple, pour « Collecte d’encombrants » :

    http://dev-api.ville.quebec.qc.ca/open311/v2/services/1934303d-7f43-e111-85e1-005056a60032.xml
    http://dev-api.ville.quebec.qc.ca/open311/v2/services/1934303d-7f43-e111-85e1-005056a60032.json

  3. Liste des requêtes existantes

  4. GET Service Requests

    Permet d’obtenir le statut de plusieurs requêtes simultanément de trois façons :

  5. GET Service Request

    Permet d’obtenir le détai,l dont le statut d’une requête, en utilisant le numéro de la requête (service_request_id)

    http://dev-api.ville.quebec.qc.ca/open311/v2/requests/UnGuidDeRequête.xml
    http://dev-api.ville.quebec.qc.ca/open311/v2/requests/UnGuidDeRequête.json

  6. GET service_request_id from a token

    Permet d’obtenir le numéro de requête advenant que celui-ci soit créé de façon asynchrone. Détailler cette fonctionnalité si possible.
    http://dev-api.ville.quebec.qc.ca/open311/v2/requests/UnGuidDeRequête.xml
    http://dev-api.ville.quebec.qc.ca/open311/v2/requests/UnGuidDeRequête.json

  7. Création d’une requête

  8. Post Service Request

    Permet d’insérer des données.
    Il n’est pas nécessaire d’authentifier l’utilisateur citoyen pour soumettre une requête.
    Aucune modification ou suppression de requête n’est permise. Seul le système met à jour les champs «statut» et «date de modification» lorsqu’une requête est résolue.

Informations supplémentaires

Documentation de la norme Open311 - GeoReportv2
http://wiki.open311.org/GeoReport_v2

Groupe de discussion technique Open311
http://lists.open311.org/groups/discuss

Points de services par juridiction (Villes)
http://wiki.open311.org/GeoReport_v2/Servers

Statut des points de services
http://open311status.herokuapp.com/

Application « GeoReporter » (permet d’ajouter et tester un point de service Open311) :

Clé API

Demandez une clé API pour utiliser ce service ouvert!

© Ville de Québec, 2014. Tous droits réservés.