DOCUMENTATION API REST/JSONAZKO-CMS API - v1.0

Informations générales

API AZKO-CMS API
Version 1.0
Auteur AZKO.FR (Benj F.)
URL https://api.azko.fr
API authentication basic Toutes les requêtes doivent comporter les identifiants d'API qui vous ont été communiqués par nos services :
[YOUR_API_KEY] + [YOUR_API_SECRET] envoyés dans un header Authorization:Basic (legacy) ou AppId pour l'authentification via SSO SEPTEO
    Exemples (via SSO SEPTEO) :
  • HTTP > AppId: [base64([YOUR_API_KEY]:[YOUR_API_SECRET])]
  • PHP > curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'AppId: ' . base64_encode('[YOUR_API_KEY]:[YOUR_API_SECRET]')
    ));
  • CURL > curl --request POST --url https://api.azko.fr/... --header 'AppId: [base64([YOUR_API_KEY]:[YOUR_API_SECRET])]' --header 'content-type: application/json' --data '{"...":"..."}'
    Exemples (legacy) :
  • HTTP > Authorization:Basic [base64([YOUR_API_KEY]:[YOUR_API_SECRET])]
  • PHP > curl_setopt($ch, CURLOPT_USERPWD, "[YOUR_API_KEY]:[YOUR_API_SECRET]")
  • CURL > curl --request POST --url https://api.azko.fr/... --header 'Authorization:Basic [base64([YOUR_API_KEY]:[YOUR_API_SECRET])]' --header 'content-type: application/json' --data '{"...":"..."}'
USER authentication string Toutes les requêtes (sauf /errors et /auth) doivent également comporter un "USER-TOKEN" ou un "JSON WEB TOKEN".
Pour obtenir ce TOKEN ou ce JWT, 3 méthodes au choix :
  1. JWT SSO SEPTEO: Depuis le SSO "login.septeo.fr".
    Envoyer ensuite ce JWT dans un header "Authorization: Bearer [...]".
    Exemple :
    • HEADER : Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.[...]

  2. TOKEN (Legacy) : Depuis le endpoint "/auth" (ou communiqué par nos services).
    Envoyer ensuite ce TOKEN en paramètre ou en contenu de la requête.
    Exemples :
    • URL : ?token=...
    • JSON : {"token":"..."}

  3. JWT MySepteo (Legacy) : Depuis le endpoint "/auth/mySepteo".
    Envoyer ensuite ce JWT dans un header "Application-Authorization: Bearer [...]".
    Exemple :
    • HEADER : Application-Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.[...]
Retour si succès json
{
    "output": {
        "success": 1,
        "response": "..."
    }
}
Retour si erreur json
{
    "output": {
        "success": 0,
        "error": {
            "num": "...",
            "msg": " ... "
        }
    }
}

Détail des webservices

Endpoints : Tout déplier / replier
Détails : Tout déplier / replier

/errors (1)

GET /errors
/errors GET
Liste des erreurs pouvant être retournées par l'API
Détails

/auth (6)

POST /auth
POST /auth/mySepteo
POST /auth/checkToken
POST /auth/passPerdu
POST /auth/requestAccount
POST /auth/logOff
/auth POST
Authentification de l'utilisateur via login/pass (complémentaire avec l'API Authentication)
Retourne le TOKEN nécessaire pour les autres requêtes
Détails
/auth/mySepteo POST
Authentification de l'utilisateur via login/pass (complémentaire avec l'API Authentication)
Retourne un JSON WEB TOKEN nécessaire pour les autres requêtes
Détails
/auth/checkToken POST
Vérifie si le token est valide
Détails
/auth/passPerdu POST
Envoi un mail de confirmation de réinitialisation de mot de passe à l'utilisateur
Détails
/auth/requestAccount POST
Envoi un mail de demande d'identifiants aux services AZKO
TODO Méthode en cours de développement !
Détails
/auth/logOff POST
Déconnexion = supprime le token
Détails

/users (3)

GET /users[/:id][/:id]...
GET /users/current
POST /users/:id
/users[/:id][/:id]... GET
Retourne un ou des user(s)
Détails
/users/current GET
Retourne l'utilisateur courant
Détails
/users/:id POST
Modification user (ne modifie que Nom, Prénom, et Mot de passe (optionnel))
Détails

/organisations (4)

GET /organisations[/:id][/:id]...
GET /organisations/current
GET /organisations/search
PUT /organisations/:id
/organisations[/:id][/:id]... GET
Retourne une ou des organisation(s)
Détails
/organisations/current GET
Retourne l'organisation courante
Détails
/organisations/search GET
Retourne une organisation en se basant sur son nom strict ou id groupe MySepteo
Détails
/organisations/:id PUT
Modification organisation
Détails

/sites (4)

GET /sites[/:id][/:id]...
GET /sites/facebookAccounts
GET /sites/twitterAccounts
GET /sites/domainNames
/sites[/:id][/:id]... GET
Retourne un ou des site(s)
Détails
/sites/facebookAccounts GET
Retourne les comptes facebook associés aux sites
Détails
/sites/twitterAccounts GET
Retourne les comptes twitter associés aux sites de l'ORGANISATION COURANTE
Détails
/sites/domainNames GET
Retourne les noms de domaine associés aux sites de l'ORGANISATION COURANTE
Détails

/blogcategories (1)

GET /blogcategories[/:id][/:id]...
/blogcategories[/:id][/:id]... GET
Retourne une ou des catégorie(s) de blog
Détails

/blogit (6)

POST /blogit/getFormLogin
POST /blogit/getForm
POST /blogit/searchImages
POST /blogit/presend
POST /blogit/send
POST /blogit/sendToQueue
/blogit/getFormLogin POST
Retourne le formulaire d'identitfication de BLOG'IT
Détails
/blogit/getForm POST
Retourne le formulaire d'envoi d'article de BLOG'IT
Détails
/blogit/searchImages POST
Retourne la liste d'images recherchées dans la librairie BLOG'IT
Détails
/blogit/presend POST
Simule l'envoi d'un article via le formulaire de BLOG'IT
Détails
/blogit/send POST
Envoi un article via le formulaire de BLOG'IT
Détails
/blogit/sendToQueue POST
Envoi un article en file d'attente via le formulaire de BLOG'IT
Détails

/articles (3)

GET /articles[/:id][/:id]...
GET /articles/publicationsResume
POST /articles[/:id]
/articles[/:id][/:id]... GET
Retourne un ou des article(s)
Détails
/articles/publicationsResume GET
Retourne des stats de publication des articles
Détails
/articles[/:id] POST
Enregistre (créé ou modifie) un article
Détails

/ateliers (1)

GET /ateliers[/:id][/:id]...
/ateliers[/:id][/:id]... GET
Retourne un ou des ateliers(s)
Détails

/contacts (3)

GET /contacts[/:id][/:id]...
POST /contacts
PUT /contacts/statuts/:id
/contacts[/:id][/:id]... GET
Retourne une ou des demande(s) de contact
Détails
/contacts POST
Créé une demande de contact (modification interdite)
Détails
/contacts/statuts/:id PUT
Modifie le statut du traitement de la demande de contact ou le lu/non lu de la demande
Détails

/encaissements (1)

GET /encaissements
/encaissements GET
Retourne un ou des encaissements(s)
Détails

/boutiques (1)

GET /boutiques/commandes[/:id][/:id]...
/boutiques/commandes[/:id][/:id]... GET
Retourne les commandes boutiques
Détails

/paiementsLibres (2)

GET /paiementsLibres[/:id][/:id]...
GET /paiementsLibres/token[/:id][/:id]
/paiementsLibres[/:id][/:id]... GET
Retourne un ou des paiements libres(s)
Détails
/paiementsLibres/token[/:id][/:id] GET
Calcule et retourne un token de protection à partir d'un ou plusieurs champs d'un formulaire de paiement libre, à injecter dans l'url de formulaire de paiement
Le ou les champs envoyés seront considérés comme non modifiables dans le formulaire de paiement (et une erreur sera retournée si les données ne sont pas conformes).
Détails

/annuaire (11)

GET /annuaire/dictionnaires
GET /annuaire/domainesArbo
GET /annuaire/domainesLightListePlate
GET /annuaire/membres[/:id][/:id]...
POST /annuaire/membres
PUT /annuaire/membres/:id
DELETE /annuaire/membres/:id
GET /annuaire/structures[/:id][/:id]...
POST /annuaire/structures
PUT /annuaire/structures/:id
DELETE /annuaire/structures/:id
/annuaire/dictionnaires GET
Retourne les dictionnaires (Listes des différentes valeurs possibles pour les champs Spécialités, Domaines de compétences, Langues, Moyens de paiement, Applis, Devises...)
Format "id":"libellé"
Détails
/annuaire/domainesArbo GET
Retourne les Domaines de compétences sous forme d'arbo
Format "id":{domaine}
Détails
/annuaire/domainesLightListePlate GET
Retourne les Domaines de compétences sous forme d'arbo en liste plate
Format "id":{domaine}
Détails
/annuaire/membres[/:id][/:id]... GET
Retourne une ou des fiches "membre"
Détails
/annuaire/membres POST
Enregistre (créé) une nouvelle fiche "membre" (sans préciser d'id)
Détails
/annuaire/membres/:id PUT
Enregistre (crée ou modifie) une fiche "membre" (en précisant obligatoirement l'id)
Détails
/annuaire/membres/:id DELETE
Supprime une fiche membre
Détails
/annuaire/structures[/:id][/:id]... GET
Retourne une ou des fiches "structures"
Détails
/annuaire/structures POST
Enregistre (créé) une nouvelle fiche "structure" (sans préciser d'id)
/!\ En cours de développement...
Détails
/annuaire/structures/:id PUT
Enregistre (crée ou modifie) une fiche "structure" (en précisant obligatoirement l'id)
/!\ En cours de développement...
Détails
/annuaire/structures/:id DELETE
Supprime une fiche structure
Détails

/annonces (12)

GET /annonces[/:id][/:id]...
POST /annonces
PUT /annonces/:id
PUT /annonces/ncis/:id-ncis
PUT /annonces/netty/:id-netty
DELETE /annonces/:id
DELETE /annonces/ncis/:id-ncis
DELETE /annonces/netty/:id-netty
GET /annonces/typesannonces
GET /annonces/types
GET /annonces/soustypes
GET /annonces/lieuxVente
/annonces[/:id][/:id]... GET
Retourne une ou des annonces
Détails
/annonces POST
Enregistre (créé) une nouvelle annonce (sans préciser d'id)
Détails
/annonces/:id PUT
Enregistre (crée ou modifie) une annonce (en précisant obligatoirement l'id)
Détails
/annonces/ncis/:id-ncis PUT
Enregistre (créé ou modifie) une annonce NCIS (en précisant obligatoirement l'id "NCIS")
Détails
/annonces/netty/:id-netty PUT
Enregistre (créé ou modifie) une annonce NETTY (en précisant obligatoirement l'id "NETTY")
Détails
/annonces/:id DELETE
Supprime une annonce
Détails
/annonces/ncis/:id-ncis DELETE
Supprime une annonce NCIS
Détails
/annonces/netty/:id-netty DELETE
Supprime une annonce NETTY
Détails
/annonces/typesannonces GET
Retourne la liste des types d'annonces
Détails
/annonces/types GET
Retourne la liste des types de biens
Détails
/annonces/soustypes GET
Retourne la liste des sous types de biens
Détails
/annonces/lieuxVente GET
Retourne la liste des lieux de ventes pouvant être sélectionnés dans le cadre d'une enchère de biens
Détails

/stats (12)

GET /stats/contacts[/:siteid]
GET /stats/biens
GET /stats/articles
GET /stats/paiements
GET /stats/encaissements[/:siteid]
GET /stats/analyticsDaily/:siteurl
GET /stats/analytics/:siteurl
GET /stats/myPoseo/:siteurl
GET /stats/myPoseoDaily/:siteurl
GET /stats/socialResume
GET /stats/facebook/:accountName
GET /stats/twitter/:accountName
/stats/contacts[/:siteid] GET
Retourne les stats de nb de contacts par mois ou par jour
Par mois le retour correspond au premier apireturn (soit le fonctionnement par défaut)
Par jour le retour correspond au deuxième apireturn
Détails
/stats/biens GET
Retourne les stats de nb de biens par jour pour un intervalle de temps donnés
Détails
/stats/articles GET
Retourne les stats de nb d'articles publiés par jour pour un intervalle de temps donnés
Détails
/stats/paiements GET
Retourne les stats du nombre de paiements par jour avec leur somme journalière pour un statut donné
Détails
/stats/encaissements[/:siteid] GET
Retourne les stats de nb d'encaissements par mois, le total et la moyenne
Détails
/stats/analyticsDaily/:siteurl GET
Retourne les stats Google Analytics par jour d'un site sur une plage de dates
Détails
/stats/analytics/:siteurl GET
Retourne les stats Google Analytics sur 1 année glissante
Détails
/stats/myPoseo/:siteurl GET
Retourne les stats de MyPoseoWs
Détails
/stats/myPoseoDaily/:siteurl GET
Retourne les stats de MyPoseoWs sur une plage de dates
Détails
/stats/socialResume GET
Retourne un résumé des stats de Twitter et Facebook de tous les comptes de l'organisation courante
Détails
/stats/facebook/:accountName GET
Retourne les stats de Facebook
Détails
/stats/twitter/:accountName GET
Retourne les stats de Twitter
Détails

/infosMobiles (1)

GET /infosMobiles[/:id][/:id]...
/infosMobiles[/:id][/:id]... GET
Retourne une ou des info(s) mobile(s) - (Articles de AZKO pour les clients APPLICATION MOBILE)
Détails

/infosMobilesTest (1)

GET /infosMobilesTest[/:id][/:id]...
/infosMobilesTest[/:id][/:id]... GET
Retourne une ou des info(s) mobile(s) - (Articles de AZKO pour les clients APPLICATION MOBILE)
Détails

/devicePushs (3)

GET /devicePushs
POST /devicePushs
DELETE /devicePushs
/devicePushs GET
Retourne un ou des devicePush(s) du token courant
Détails
/devicePushs POST
Enregistre un nouveau devicePush pour le token courant
Détails
/devicePushs DELETE
Supprime un devicePush
Détails
^