API ProgAccess

Nous développons une API afin de permettre aux développeurs d'exploiter les données de ProgAccess facilement en JSON. Le site est donc en open-data.

Documentation

Numéros de version

Au format 0.0.0-0 (majeure.mineure.correctif-compatibilité)
La version de l'API peut être différente, seul l'identifiant de compatibilité indique si un lecteur peut être compatible avec le serveur.
Par exemple, un lecteur fait pour la 1.2.3-4 sera compatible avec la 1.4.2-4 mais pas avec la 1.5.0-5.

La version actuelle est la 0.5.3-3.

Données

Les données renvoyées par le serveur peuvent être choisies en modifiant les paramètres GET. Plusieurs paramètres peuvent être utilisés simultanément. La racine est /api/get.php.

• Par défaut :
  • api_version: Version de l'API
• g: Informations générales
  • name: Nom du site
  • slogan: Slogan du site
  • lang: Langue actuelle (peut être changée avec le paramètre ?lang)
  • version_id: ID de la version du site
  • version_name: Numéro de la version du site
  • version_time: Date de publication de la version du site
  • maintenance: Mode maintenance
  • domain: Domaine courant
  • visits_year: Nombre de visites sur ce domaine depuis 1 an
  • visits_day: Nombre de visites sur ce domaine depuis minuit
  • visitors_week: Nombre de visiteurs sur ce domaine depuis 7 jours
  • visitors_day: Nombre de visiteurs sur ce domaine depuis minuit
  • languages: liste des langues [id, code, nom, priorité]
• slides: Slides
  • [0]: id
  • [1]: lang
  • [2]: label
  • [3]: style
  • [4]: title
  • [5]: title_style
  • [6]: content
  • [7]: content_style
  • [8]: date
• c: Catégories
  • [0]: id
  • [1]: name
  • [2]: text
• a(=id)?: Articles
  • [0]: id
  • [1]: name
  • [2]: category
  • [3]: date
  • [4]: hits
  • [5]: downloads
  • [6]: author
  • [7]: archive_after
• ca(=id): Articles de la catégorie {id}
  • [0]: id
  • [1]: name
  • [2]: date
  • [3]: hits
  • [4]: downloads
  • [5]: author
  • [6]: archive_after
• at(=id)?: Contenus d'articles (sans le contenu)
  • [0]: id
  • [1]: lang
  • [2]: article_id
  • [3]: name
  • [4]: date
  • [5]: keywords
  • [6]: description
  • [7]: website
  • [8]: author
• cat(=id): Contenus d'articles de la catégorie {id} (sans le contenu)
  • [0]: id
  • [1]: lang
  • [2]: article_id
  • [3]: name
  • [4]: date
  • [5]: keywords
  • [6]: description
  • [7]: website
  • [8]: author
• att(=id)?: Contenus d'articles (avec le contenu)
  • [0]: id
  • [1]: lang
  • [2]: article_id
  • [3]: name
  • [4]: date
  • [5]: keywords
  • [6]: description
  • [7]: website
  • [8]: author
  • [9]: text
• catt(=id): Contenus d'articles de la catégorie {id} (avec le contenu)
  • [0]: id
  • [1]: lang
  • [2]: article_id
  • [3]: name
  • [4]: date
  • [5]: keywords
  • [6]: description
  • [7]: website
  • [8]: author
  • [9]: text
• su: Mises à jour du site
  • [0]: id
  • [1]: name
  • [2]: text
  • [3]: date
  • [4]: authors
  • [5]: codestat
• af(=id)?: Fichiers d'articles
  • [0]: id
  • [1]: article_id
  • [2]: name
  • [3]: filetype
  • [4]: title
  • [5]: date
  • [6]: filesize
  • [7]: hits
  • [8]: label
  • [9]: md5
  • [10]: sha1
  • [11]: arch
  • [12]: platform
• aaf(=id): Fichiers de l'article {id}
  • [0]: id
  • [1]: name
  • [2]: filetype
  • [3]: title
  • [4]: date
  • [5]: filesize
  • [6]: hits
  • [7]: label
  • [8]: md5
  • [9]: sha1
  • [10]: arch
  • [11]: platform
• afl(=label)?: Fichiers d'articles (par label)
  • [0]: id
  • [1]: article_id
  • [2]: name
  • [3]: filetype
  • [4]: title
  • [5]: date
  • [6]: filesize
  • [7]: hits
  • [8]: label
  • [9]: md5
  • [10]: sha1
  • [11]: arch
  • [12]: platform
• am(=id)?: Miroirs d'articles
  • [0]: id
  • [1]: article_id
  • [2]: links
  • [3]: title
  • [4]: date
  • [5]: hits
  • [6]: label
• aam(=id): Miroirs de l'article {id}
  • [0]: id
  • [1]: links
  • [2]: title
  • [3]: date
  • [4]: hits
  • [5]: label
• aml(=label)?: Miroirs d'articles (par label)
  • [0]: id
  • [1]: article_id
  • [2]: links
  • [3]: title
  • [4]: date
  • [5]: hits
  • [6]: label

Exemples :

• https://www.progaccess.net/api/get.php?g&a&att affichera les infos générales du site, ainsi que la liste des articles, leurs métadonnées et leurs contenus dans toutes les langues.
• https://www.progaccess.net/api/get.php?a=42 affichera l'article 42

Note : Les fichiers et miroirs d'articles ont tous un ID unique, mais également un label (optionnel). Lors d'une mise à jour d'un fichier/miroir, l'ID change mais le label peut rester le même. Par exemple, "Firefox ESR pour Windows 64 bits" aura toujours le même label firefoxesr64.