freshrss/edge/docs/fr/users

06_Mobile_access
Edited: Tuesday 15 September 2026

Cette page suppose que vous ayez fini l’installation du
serveur
.

Activer l’API dans FreshRSS

  1. Dans la section “Authentification”, cocher l’option “Autoriser l’accès
    par API (nécessaire pour les applis mobiles)”.
  2. Dans la section “Profil”, remplir le champ “Mot de passe API (ex. : pour applis mobiles)”.
    • Chaque utilisateur doit choisir son mot de passe API.
    • La raison d’être d’un mot de passe API
      différent du mot de passe principal est que le mot de passe API est
      potentiellement utilisé de manière moins sûre, mais il permet aussi moins de choses.

Le reste de cette page concerne l’API compatible Google Reader. Voir la
page sur l’API compatible Fever pour une autre
possibilité.

Tester

  1. Dans la section “Profil”, cliquer sur le lien de la forme
    https://rss.example.net/api/ à côté du champ “Mot de passe API”.
  2. Cliquer sur le premier lien “Check full server configuration”:
    • Si vous obtenez PASS, tout est bon : passer à l’étape 6.
    • Si vous obtenez Bad Request! ou Not Found, alors votre serveur ne semble pas accepter les slashs / qui sont encodés %2F. Passer à l’étape 5.
    • Si vous obtenez un autre message d’erreur, passer à l’étape 5.

Déboguer la configuration du serveur

  • Cliquer sur le second lien “Check partial server configuration (without %2F support)”:
    • Si vous obtenez PASS, alors le problème est bien que votre serveur n’accepte pas les slashs / qui sont encodés %2F.
      • Avec Apache, vérifiez la directive AllowEncodedSlashes On
      • Ou utilisez un client qui n’encode pas les slashs (comme EasyRSS), auquel cas passer à l’étape 6.
    • Si vous obtenez Service Unavailable!, retourner à l’étape 6.
    • Avec Apache:
      • Si vous obtenez FAIL getallheaders!, alors la combinaison de votre version de PHP et de votre serveur Web ne permet pas l’accès à getallheaders
    • Avec nginx:
      • Si vous obtenez Bad Request!, vérifier la configuration PATH_INFO de votre serveur.
      • Si vous obtenez File not found!, vérifier la configuration fastcgi_split_path_info de votre serveur.
    • Si vous obtenez FAIL 64-bit or GMP extension!, alors votre installation PHP soit n’est pas en 64 bit, soit n’a pas l’extension PHP GMP activée.
      • Le plus simple est d’activer l’extension GMP. Sur Debian / Ubuntu : sudo apt install php-gmp
    • Mettre à jour et retourner à l’étape 3.

Clients compatibles

  1. Sur la même page de l’API FreshRSS, notez l’adresse donnée sous “Votre adresse API”, comme https://freshrss.example.net/api/greader.php

    • Saisissez l’adresse de l’API dans le client sélectionné puis votre nom d’utilisateur et votre mot de passe spécialement créé pour l’API.
  2. Vous pouvez maintenant tester sur une application mobile comme :

ℹ️ Voir une meilleure liste des applications mobiles compatibles.

API compatible Google Reader

Exemples de requêtes simples :

 1# Authentification utilisant le mot de passe API via POST
 2curl -X POST -d 'Email=alice&Passwd=Abcdef123456' 'https://freshrss.example.net/api/greader.php/accounts/ClientLogin'
 3SID=alice/8e6845e089457af25303abc6f53356eb60bdb5f8
 4Auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8
 5
 6# Exemples de requêtes en lecture
 7curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
 8  'https://freshrss.example.net/api/greader.php/reader/api/0/subscription/list?output=json'
 9
10curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
11  'https://freshrss.example.net/api/greader.php/reader/api/0/unread-count?output=json'
12
13curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
14  'https://freshrss.example.net/api/greader.php/reader/api/0/tag/list?output=json'
15
16# Demande de jeton pour faire de requêtes de modification
17curl -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
18  'https://freshrss.example.net/api/greader.php/reader/api/0/token'
198e6845e089457af25303abc6f53356eb60bdb5f8ZZZZZZZZZZZZZZZZZ
20
21# Récupère les articles, envoyés à jq pour une lecture JSON plus facile
22curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
23  'https://freshrss.example.net/api/greader.php/reader/api/0/stream/contents/reading-list' | jq .
24
25# Se désabonner d’un flux
26curl -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
27  -d 'ac=unsubscribe&s=feed/52' 'https://freshrss.example.net/api/greader.php/reader/api/0/subscription/edit'

Plus de documentation