Hoshinplan

API Docs

Goals

>>>

GET /goals/:id
Get a long term goal

Ejemplos

curl "https://www.hoshinplan.com/goals/45544?app_key=<APP_KEY>&timestamp=<TIMESTAMP>&signature=<SIGNATURE>" \
-H "Accept: application/json"


Response:
{
    "id": 21344,
    "name": "My goal",
    "created_at": "2021-01-28T18:28:23.492Z",
    "updated_at": "2021-01-29T09:21:33.533Z",
    "hoshin_id": 1234,
    "position": 1,
    "company_id": 2345234,
    "creator_id": 234234,
    "deleted_at": null
}

Respuesta

Código HTTP: 200

Descripción:

OK

Nombre del parámetro Descripción
id
opcional

Validations:

  • Must be a number.
name
opcional

Validations:

  • Must be a String
created_at
opcional

Validations:

  • Must be Date.
updated_at
opcional

Validations:

  • Must be Date.
hoshin_id
opcional

The id of the area this goal belongs to

Validations:

  • Must be a number.
company_id
opcional

The id of the company this objective belongs to

Validations:

  • Must be a number.
position
opcional

Used to sort the goals in the hoshin view

Validations:

  • Must be a number.
>>>

PUT /goals/:id
Update a long term goal

Formatos soportados

json, xml

Ejemplos

curl -X PUT "https://www.hoshinplan.com/goals/45544?app_key=<APP_KEY>&timestamp=<TIMESTAMP>&signature=<SIGNATURE>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "name": "This is the new name"
}'

Parámetros

Nombre del parámetro Descripción
name
opcional

Validations:

  • Must be a String
position
opcional

Used to sort the goals in the hoshin view

Validations:

  • Must be a number.

Respuesta

Código HTTP: 200

Descripción:

The updated long term goal

Nombre del parámetro Descripción
id
opcional

Validations:

  • Must be a number.
name
opcional

Validations:

  • Must be a String
created_at
opcional

Validations:

  • Must be Date.
updated_at
opcional

Validations:

  • Must be Date.
hoshin_id
opcional

The id of the area this goal belongs to

Validations:

  • Must be a number.
company_id
opcional

The id of the company this objective belongs to

Validations:

  • Must be a number.
position
opcional

Used to sort the goals in the hoshin view

Validations:

  • Must be a number.
>>>

POST /hoshins/:hoshin_id/goals
Create a long term goal for the given hoshin

Formatos soportados

json, xml

Ejemplos

curl -X POST "https://www.hoshinplan.com/hoshins/12312/goals?app_key=<APP_KEY>&timestamp=<TIMESTAMP>&signature=<SIGNATURE>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "name": "My new goal"
}'

Parámetros

Nombre del parámetro Descripción
name
requerido

Validations:

  • Must be a String
position
opcional

Used to sort the goals in the hoshin view

Validations:

  • Must be a number.

Respuesta

Código HTTP: 201

Descripción:

The newly created goal

Nombre del parámetro Descripción
id
opcional

Validations:

  • Must be a number.
name
opcional

Validations:

  • Must be a String
created_at
opcional

Validations:

  • Must be Date.
updated_at
opcional

Validations:

  • Must be Date.
hoshin_id
opcional

The id of the area this goal belongs to

Validations:

  • Must be a number.
company_id
opcional

The id of the company this objective belongs to

Validations:

  • Must be a number.
position
opcional

Used to sort the goals in the hoshin view

Validations:

  • Must be a number.
>>>

DELETE /goals/:id
Delete a long term goal

Ejemplos

curl -X DELETE "https://www.hoshinplan.com/goals/45544?app_key=<APP_KEY>&timestamp=<TIMESTAMP>&signature=<SIGNATURE>" \
-H "Accept: application/json"

Respuesta

Código HTTP: 204

Descripción:

No Content

Nombre del parámetro Descripción