PropertyRequirement

Los Properties pueden tener ServiceSkills asociados como requisito. Esto le permite al servidor enlazar dichos Properties con los Providers que posean esos ServiceSkills. En el caso de los Properties, los llamaremos requisitos (requirements) y para los Providers serán habilidades (skills).

Esta entidad funciona como pivote, es decir, enlaza la entidad Property con la entidad ServiceSkill, pero su estructura interna no es expuesta en ningún end-point.

Anexar Respuestas Globales


Lista Property -> ServiceSkills

Obtiene una lista de ServiceSkill asignados a un Property ordenados alfabéticamente (orden natural).

Permisos

Endpoint

Método URI Cabeceras
GET /properties/{property-id}/service-skills Authorization
  • {property-id}: El id del Property al cual se consultan sus ServiceSkills asociados.

Parámetros

Ninguno

Respuesta del API

{success} Respuesta satisfactoria.

Código 200 ServiceSkill[]

[
  {
    "id"        : 1,
    "name"      : "Cuidado de Bebés 0-12 meses",
    "created_at": "2019-08-27 16:41:59",
    "updated_at": "2019-08-27 16:41:59"
  }
]

Lista ServiceSkill -> Properties

Obtiene una lista de Properties que asociados al ServiceSkill.

Permisos

Endpoint

Método URI Cabeceras
GET /service-skills/{serviceSkillId}/properties Authorization
  • {id}: El id del ServiceSkill al cual se consultan sus Properties asociados.

Parámetros

Ninguno

Respuesta del API

{success} Respuesta satisfactoria.

Código 200 Property[]

[
  {
    "id"               : 29,
    "name"             : "Ajaaa",
    "type"             : 1024,
    "disabled"         : false,
    "created_at"       : "2019-06-13 19:33:50",
    "updated_at"       : "2019-08-27 18:51:53"
  },
  {
    "id"               : 6,
    "name"             : "Decoraciones",
    "type"             : 1024,
    "disabled"         : false,
    "created_at"       : "2019-02-18 14:17:14",
    "updated_at"       : "2019-06-04 13:30:06"
  }
]

Vincular

Asocia un ServiceSkill con un Property.

Permisos

Endpoint

Método URI Cabeceras
PUT /service-skills/{serviceSkillId}/properties/{property-id} Authorization
  • {property-id}: El id del Property a vincular.

Parámetros

Ninguno

Respuesta del API

{success} Respuesta satisfactoria.

Código 204

No Content

Desvincular

Desvincula un ServiceSkill de un Property.

Permisos

Endpoint

Método URI Cabeceras
DELETE /service-skills/{serviceSkillId}/properties/{property-id} Authorization
  • {property-id}: El id del Property a desvincular.

Parámetros

Ninguno

Respuesta del API

{success} Respuesta satisfactoria.

Código 204

No Content

Sincronizar

Modifica las asociaciones de ServiceSkill y Properties, es decir, la sincronización reemplaza todas las asociaciones anteriores. Por ejemplo:

Antes: [1,2,3] El ServiceSkill posee asociados los Properties con id 1,2,3.

Envío: [2,4] Se envían los Ids 2 y 4 para la sincronización.

Resultado: [1,3] Los Ids 1 y 4 fueron desvinculados, el Id 2 se mantuvo y el Id 4 fue agregado

Permisos

Endpoints

Método URI Cabeceras
PUT /service-skills/{serviceSkillId}/properties Authorization
PUT /properties/{propertyId}/service-skills Authorization

{info} La diferencia entre los endpoints es cómo se realiza la sincronización. En el endpoint /service-skills/{serviceSkillId}/properties se reemplazan los Properties para un ServiceSkill; en el endpoint /properties/{propertyId}/service-skills se reemplazan los requisitos para el Property especificado.

Parámetros Body

[3, 9]

Respuesta del API

{success} Respuesta satisfactoria.

Código 200

{
  "attached": [3, 9],
  "detached": [63],
  "updated" : []
}
  • attached: Ids de los elementos vinculados.
  • detached: Ids de los elementos desvinculados.
  • updated: Ids de los actualizados o mantenidos.