Pour accesser le Newsman API par l’intermède de l’authentification OAuth2, il faut parcourir les étapes:
L’enregistrement de l’application laquelle utilisera l’API avec l’authentification OAuth2
Utilisez le formulaire de contact et envoyez nous les suivantes donnes:
- Le nom de l’application;
- redirect_uri: Callback URL où Newsman vous envoyera un callback (ex: https://situlmeu.ro/callback)
Nous vous mettrons deux paramètres à votre disposition, lesquels vous les utiliserez à l’authentification:
- client_id (par exemple: app_client_example)
- client_secret (par exemple: 123123123123)
L’authentification
Le Newsman API utilise pour authentification le protocole OAuth 2.0
Toutes les requestes vers API doivent être faites en utilisant SSL (https:// pas le http://)
- client_id (on vous l’envoie après l’enregistrement de l’application)
- client_secret  (on vous l’envoie après l’enregistrement de l’application)
- Athorization endpoint: https://ssl.newsman.ro/admin/oauth/authorize
- Token endpoint: https://ssl.newsman.ro/admin/oauth/token
Le premier pas: Guidez l’utilisateur vers l’url d’autorisation
https://ssl.newsman.ro/admin/oauth/authorize?scope=api&redirect_uri=https%3A%2F%2Fsitulmeu.ro%2Fcallback&response_type=code&client_id=app_client_example
Si l’utilisateur n’est pas authentifié en Newsman, il serait guidé vers le formulaire de login. L’utilisateur serait démandé s’il permet à l’application d’accéder son Newsman compte.
Le deuxième pas: La redirection Newsman vers le Callback URL
https://situlmeu.ro/callback?code=jksasda4sda5ssd1a1122sdassdas123
Si l’utilisateur n’a pas permis l’accès dans le Newsman compte, il serait réorienté vers l’url
https://situlmeu.ro/callback?error=access_denied&error_description=end-user+denied+authorization
Le troisième pas: Obtenir l’access_token
Dans le démarche antérieur on a obtenu le “code” qui doit être change avec un “access_token” (API key).
Pour le changer, faites un request POST dans access_token endpoint https://ssl.newsman.ro/admin/oauth/token, en utilisant les paramètres:
– code=d869078edb8658f7ccaae5545d506662
– redirect_uri=https%3A%2F%2Fsitulmeu.ro%2Fcallback
– client_id=app_client_example
– client_secret=123123123123
– grant_type=authorization_code
S’il n’y a pas des erreurs, vous recevrez une réponse JSON de type:
{ "user_id": 2312121, "access_token": "6c595cd6db27b05dya3be2f65e28291f", "expires_in": 1709550943, "lists": [1, 2], "token_type": "bearer", "scope": "api" } |
L’access_token obtenu (nommé API key) sera utilisé par vous chaque fois que vous appelez l’API à côté de l’user_id.