Noco/API/users : Différence entre versions

Version du 6 mai 2018 à 16:21

users.json est une bibliothèque de l'API noco permettant de récupérer des informations sur les utilisateurs

users/init : Informations sur l'utilisateur connecté

Requête : https://api.noco.tv:443/1.1/users/init

Méthode GET : récupérer les informations

Réponse :

{
 "user": {
   "id_user": 000                     //Numéro de l'utilisateur connecté
   "username": "xxx"                  //Pseudo de l'utilisateur connecté
   "geoloc": "FR"                     //Pays (ISO 3166-1) de l'adresse IP
 },
 "options": {                    //Options disponibles sur le site noco.tv
   "do_not_track": 0,                 //1 = noco n'enregistre plus d'infos
                                      //    sur les visionnages. Certaines
                                      //    fonctionnalités ne sont plus
                                      //    disponibles (historique,
                                      //    recommandations, reprise) 
   "quality": "HD_1080",              //Qualité par défaut en HTML5
   "quality_mobile": "HD_1080",       //Qualité par défaut en Flash
                                      //HD_1080, HD_720, TV, HQ ou LQ
   "quality_auto": 1,                 //1 = activer la qualité automatique
   "language": "ja",                  //Langue (ISO 631-1) de l'interface
   "audio_language": "original",      //Piste audio par défaut
                                      //("original" ou code ISO 631-1)
   "sub_language": "fr",              //Sous-titres par défaut
                                      //(null ou code ISO 631-1)
   "autoswitchdelay": 0               //Passage à la vidéo suivante
                                      //0 = NON ou attente en secondes
 },
 "avatars": {                    //Liens vers les images de l'avatar
   "avatar_25": "https://media.noco.tv/profil/avatar/25x25/avatar-000-999.png",
   "avatar_32": "https://media.noco.tv/profil/avatar/32x32/avatar-000-999.png",
   "avatar_45": "https://media.noco.tv/profil/avatar/45x45/avatar-000-999.png",
   "avatar_128": "https://media.noco.tv/profil/avatar/128x128/avatar-000-999.png",
   "avatar_256": "https://media.noco.tv/profil/avatar/256x256/avatar-000-999.png"
 },
 "banner": {                     //Références de la bannière utilisateur
   "id_banner": 47,
   "banner": "https://media.noco.tv/profil/slider/kanthesis002.jpg"
 },
 "subscriptions": {              //Liste des abonnements en cours
   "GUA": {                           //Code du catalogue
     "name": "Standard",              //Formule ("Standard","Soutien",…)
     "soutien": 1,                    //Abonné soutien ?
     "date_start": "2016-06-24 20:07:36",
     "date_end": "2018-05-16 15:45:00"
   },
   "OLY": {
     "name": "Standard",
     "soutien": 1,
     "date_start": "2017-02-10 20:39:28",
     "date_end": "2018-05-16 15:45:00"
   }
 }
}

users/{id_user} : Informations sur un utilisateur

Requete : https://api.noco.tv:443/1.1/users/{id_user}

Méthode GET : récupérer les informations

Réponse :

{
 "user": {
   "id_user": 000                     //Numéro de l'utilisateur
   "username": "xxx"                  //Pseudo de l'utilisateur
 },
 "avatars": {
   "avatar_25": "https://media.noco.tv/profil/avatar/25x25/avatar-000-999.png",
   "avatar_32": "https://media.noco.tv/profil/avatar/32x32/avatar-000-999.png",
   "avatar_45": "https://media.noco.tv/profil/avatar/45x45/avatar-000-999.png",
   "avatar_128": "https://media.noco.tv/profil/avatar/128x128/avatar-000-999.png",
   "avatar_256": "https://media.noco.tv/profil/avatar/256x256/avatar-000-999.png"
 },
 "banner": {
   "banner": "https://media.noco.tv/profil/slider/nol004.jpg"
 }
}

users/history : Historique de visualisation

Requete : https://api.noco.tv:443/1.1/users/history?page=0&elements_per_page=40

Méthode GET : récupérer les informations

Réponse :

[
 {
   "id_show": 4302,
   "id_user": 000,
   "progress": null,
   "resume_play": 0,
   "mark_read": 1
 },
 {
   "id_show": 7250,
   "id_user": 000,
   "progress": null,
   "resume_play": 0,
   "mark_read": 1
 },
 {
   "id_show": 4975,
   "id_user": 000,
   "progress": null,
   "resume_play": 0,
   "mark_read": 1
 }
]

users/resume_play : Vidéos en cours de lecture

Requete : https://api.noco.tv:443/1.1/users/resume_play?page=0&elements_per_page=40

Méthode GET : récupérer les informations

Réponse :

[
 {
   "id_show": 15217,
   "id_user": 000,
   "progress": {
     "detail": [
       {
         "tc_end": 976092,
         "tc_start": 0
       }
     ],
     "total": 59.12
   },
   "resume_play": 976447,
   "mark_read": 1
 },
 {
   "id_show": 7143,
   "id_user": 000,
   "progress": {
     "detail": [
       {
         "tc_end": 5366763,
         "tc_start": 0
       },
       {
         "tc_end": 6186755,
         "tc_start": 6171351
       },
       {
         "tc_end": 6274208,
         "tc_start": 6273020
       },
       {
         "tc_end": 6374690,
         "tc_start": 6374689
       }
     ],
     "total": 57.16
   },
   "resume_play": 6187389,
   "mark_read": 1
 }
]

users/queue_list : Vidéos en file d'attente

Requete : https://api.noco.tv:443/1.1/users/queue_list

Méthode GET : récupérer les informations

Réponse :

[
 {
   "id_user": 000,
   "playlist_title": "File d'attente",
   "playlist_resume": null,
   "playlist": "51014,51017,51020"
 }
]

Méthode PUT : remplacer la file d'attente Postfields : '[123,456]' //Tableau de numéros de vidéos

Réponse :

[
 {
   "id_user": 000,
   "playlist_title": "File d'attente",
   "playlist_resume": null,
   "playlist": "123,456"
 }
]

Méthode DELETE : vider la file d'attente

Réponse :

[
 {
   "id_user": 000,
   "playlist_title": "File d'attente",
   "playlist_resume": null,
   "playlist": ""
 }
]

users/favorites : Familles de vidéos favorites

Requete : https://api.noco.tv:443/1.1/users/favorites

Méthode GET : récupérer les informations

Réponse :

[
 {
   "id_user": 000,
   "favorites": "235,93,66,62"
 }
]

Méthode PUT : remplacer la liste de familles favorites Postfields : '[12,34]' //Tableau de numéros de familles

Réponse :

[
 {
   "id_user": 000,
   "favorites": "12,34"
 }
]

Méthode DELETE : vider la liste de familles favorites

Réponse :

[
 {
   "id_user": 000,
   "favorites": null
 }
]