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

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:

API compatible Google Reader

Exemples de requêtes simples :

# Authentification utilisant le mot de passe API (Email et Passwd peuvent être passés en GET, ou POST - mieux)
curl 'https://freshrss.example.net/api/greader.php/accounts/ClientLogin?Email=alice&Passwd=Abcdef123456'
SID=alice/8e6845e089457af25303abc6f53356eb60bdb5f8
Auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8

# Exemples de requêtes en lecture
curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/subscription/list?output=json'

curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/unread-count?output=json'

curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/tag/list?output=json'

# Demande de jeton pour faire de requêtes de modification
curl -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/token'
8e6845e089457af25303abc6f53356eb60bdb5f8ZZZZZZZZZZZZZZZZZ

# Récupère les articles, envoyés à jq pour une lecture JSON plus facile
curl -s -H "Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8" \
  'https://freshrss.example.net/api/greader.php/reader/api/0/stream/contents/reading-list' | jq .