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"
- {
- "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",
- }
- ...
- }]
- }
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"
- {
- "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"
- ],
- }
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"
- {
- "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",
- ]
- }
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"