ProviderSkill

Los Providers pueden tener habilidades (ServiceSkills) asociadas. Esto le permite al servidor enlazar los servicios con los Providers que posean esos ServiceSkills.

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

Anexar Respuestas Globales

Lista Provider -> ServiceSkills

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

Permisos

Endpoint

Método URI Cabeceras
GET /providers/{provider-id}/service-skills Authorization
  • {provider-id}: El id del Provider 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 -> Providers

Obtiene una lista de Providers que asociados al ServiceSkill.

Permisos

Endpoint

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

Parámetros

Ninguno

Respuesta del API

{success} Respuesta satisfactoria.

Código 200 Provider[]

[
  {
    "id"          : 17,
    "account_id"  : 114,
    "name"        : "Yole",
    "display_name": "Yole",
    "email"       : "yhenriquez@manzanares.com.ve",
    "phone"       : "04148231914",
    "avatar_url"  : "https://ondemand-api.manzanares.com.ve/storage/companies/46/avatar/avatar_114_1566404947.png",
    "status"      : 289,
    "rating_e2"   : 0,
    "rating_sum"  : 0,
    "rating_count": 0,
    "latitude_e6" : 0,
    "longitude_e6": 0,
    "online_at"   : "2019-08-22 19:54:59",
    "created_at"  : "2019-08-21 16:29:07",
    "updated_at"  : "2019-08-22 19:54:59",
    "deleted_at"  : null
  }
]

Vincular

Asocia un ServiceSkill con un Provider.

Permisos

Endpoint

Método URI Cabeceras
PUT /service-skills/{serviceSkillId}/providers/{provider-id} Authorization
  • {provider-id}: El id del Provider a vincular.

Parámetros

Ninguno

Respuesta del API

{success} Respuesta satisfactoria.

Código 204

No Content

Desvincular

Desvincula un ServiceSkill de un Provider.

Permisos

Endpoint

Método URI Cabeceras
DELETE /service-skills/{serviceSkillId}/providers/{provider-id} Authorization
  • {provider-id}: El id del Provider a desvincular.

Parámetros

Ninguno

Respuesta del API

{success} Respuesta satisfactoria.

Código 204

No Content

Sincronizar

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

Antes: [1,2,3] El Provider posee asociados los ServiceSkills 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

Endpoint

Método URI Cabeceras
PUT /providers/{providerId}/service-skills Authorization

Parámetros Body

[1, 17]

Respuesta del API

{success} Respuesta satisfactoria.

Código 200

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