Schéma


Schéma


Pour connaitre la liste des champs d’un objet et la liste des sous objets disponibles vous pouvez utiliser la requête suivante :


https://{account_subdomain}.nicoka.com/api/{resource_name_in_plural}/schema/


Exemple :


curl https://{account_subdomain}.nicoka.com/api/employees/schema/ GET


-H "Authorization: Bearer


eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiZXhwIjoxNTQ4MTAyNTExfQ.a96HA5xozI_6TE65ybC5RsXdOfSuHd4Wbmhswb-V1nw"



  1. {

    • "queryUid": "9edbf7bcddfbd0f0db649b6da8680d61",

    • "offset": 10,

    • "limit": 10,

    • "page": 2,

    • "pages": 3,

    • "total": 25,

    • "data": [{

      • "id": "1",

      • "label": "Lex Luthor",

      • "employeeid": "1",

      • ...

      • "skills":[

        • "id": "1:1",

        • "label": "MySql",

        • "employeeid": "1",

        • "skillid": "1",

        • "level": "2",

        • "skill_label": "MySql",

      • },

      • {

        • "id": "1:2",

        • "label": "Php",

        • "employeeid": "1",

        • "skillid": "2",

        • "level": "4",

        • "skill_label": "Php",

        • }],

    • "languages": [

      • {

        • "id": "1:en",

        • "label": "English",

        • "employeeid": "1",

        • "code": "en",

        • "level": "4",

      • }

      • ...

    • }]

  2. }


Liste avec les sous objets uniquement


Si vous souhaitez récupérer la liste des sous objets uniquement vous devez utiliser la requête suivante comme dans l’exemple ci-après :


https://{account_subdomain}.nicoka.com/api/employees/skills/


Exemple :


curl https://{account_subdomain}.nicoka.com/api/employees/1/


-H "Authorization: Bearer


eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiZXhwIjoxNTQ4MTAyNTExfQ.a96HA5xozI_6TE65ybC5RsXdOfSuHd4Wbmhswb-V1nw"



  1. {

    • "fields": [

    • {

      • "id": "employeeid",

      • "label": "System ID",

      • "uiComponent": {

        • "id": 7,

        • "label": "Number"

      • },

      • "length": null,

    • },

    • {

      • "id": "first_name",

      • "label": "First name",

      • "uiComponent": {

        • "id": 1,

        • "label": "Input"

      • },

      • "length": 255,

    • },

    • ...

    • ],

    • "branches": [

      • "user",

      • "addresses",

      • "experiences",

      • "skills",

      • "partners",

      • "certifications",

      • "documents",

      • "salaryHistory",

      • "languages",

      • "publications",

      • "salaryBonus",

      • "educations",

      • "notes",

      • "metadata",

      • "assets",

      • "costHistory"

    • ],

  2. }


Schéma des « sous objets / branches »


Pour obtenir le schéma des sous objets d’un objet principale il suffit d’utiliser le point d’entrée suivant :


https://{account_subdomain}.nicoka.com/api/{resource_name_in_plural}/schema/{branch_name} GET


Exemple de requête :


curl https://{account_subdomain}.nicoka.com/api/employees/schema/languages GET


-H "Authorization: Bearer


eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiZXhwIjoxNTQ4MTAyNTExfQ.a96HA5xozI_6TE65ybC5RsXdOfSuHd4Wbmhswb-V1nw"



  1. {

    • "fields": [

    • {

      • "id": "code",

      • "label": "Langue parlée",

      • "uiComponent": {

        • "id": 2,

        • "label": "Liste déroulante"

        • "related": {

          • "id": "112",

          • "label": "Langue parlée",

          • "urn": "application/entities/112/values/",

        • }

      • },

      • "length": null,

    • },

    • {

      • "id": "Level",

      • "label": "Niveau",

      • "uiComponent": {

        • "id": 2,

        • "label": "Liste déroulante"

        • "related": {

          • "id": "113",

          • "label": "Niveau",

          • "urn": "application/entities/113/values/",

        • }

      • },

      • "length": null,

    • }],

    • "branches": [

      • "endorsements",

      • "languages",

    • ]

  2. }


Certains champs reposent sur des composants de type liste déroulante, il s’agit soit de liste statique (non modifiable via le paramétrage) soit de liste dynamique (reposant elle-même sur une entité de Nicoka). Dans le second cas vous verrez apparaitre les informations « related » vous donnant :


  • id : l’identifiant unique de l’entité de référence

  • label : le libellé dans la langue de requête

  • urn : le point d’entrée de l’api qui affiche les paramètres de l’entité. Si l’entité n’a pas un point d’entrée spécifique il sera toujours sous la forme « application/entities/{id_of_the_entity}/values/ » afin d’obtenir la liste des valeurs existantes pour cette entité.


Exemple de requête pour afficher la liste des niveaux de langues :


https://{account_subdomain}.nicoka.com/api/{resource_name_in_plural}/schema/{branch_name} GET


Exemple de requête :


curl https://{account_subdomain}.nicoka.com/api/application/entities/113/values/ GET


-H "Authorization: Bearer


eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiZXhwIjoxNTQ4MTAyNTExfQ.a96HA5xozI_6TE65ybC5RsXdOfSuHd4Wbmhswb-V1nw"

 Sommaire