Create new streetlight

29 Aug 2023
6 Minutes to read
Contributors

Print
Dark
Light
PDF

Create new streetlight

Updated on 29 Aug 2023
6 Minutes to read
Contributors

Print
Dark
Light
PDF

Article summary

Did you find this summary helpful?

Thank you for your feedback

Post

/el_streetlights/

Operation is used to create new streetlight. Available from product version 3.2.2.

Security

API Key

Header parameter nameAuthorization

Token issued for API consumer.

Body parameters

Streetlight to be created

object

capacitor

integer

Streetlight capacitor type id

capacitor_change_date

string

Streetlight capacitor date

choker

integer

Streetlight choker type id

color

integer

Streetlight color type id

color_rendering_index

integer

Streetlight color rendering index. Available from product version 3.2.20.

color_temperature

integer

Streetlight color temperature type id

contractor

integer

Streetlight contractor id

control_device

integer

Streetlight control device type id. Available from product version 3.2.20.

control_profile

integer

Streetlight control profile type id. Available from product version 3.2.20.

cope

integer

Streetlight cope type id

cope_change_date

string

Streetlight cope change date

creation_date

string

creation date and time

creator

string

object creator

group_change_date

string

Streetlight group change date

group_cleaning_date

string

Streetlight group cleaning date

height_accuracy

integer

Height accuracy id

integer

Primary key

ik_class

integer

Streetlight IK class type id. Available from product version 3.2.20.

installation_date

string

Installation date

installation_height

number

Installation height

installation_type

integer

Streetlight installation type id

installation_year

integer

Installation year

ip_class

integer

Streetlight IP class type id. Available from product version 3.2.20.

lamp_change_date

string

Streetlight lamp change date

lamp_count

integer

Lamp count

lamp_dimmer

integer

Streetlight lamp dimmer type id

lamp_dimmer_change_date

string

Streetlight lamp dimmer change date

lamp_dimming_class

integer

Streetlight lamp dimming class id

lamp_lighter

integer

Streetlight lamp lighter type id

lamp_lighter_change_date

string

Streetlight lamp lighter checkout date

lamp_manufacturer

integer

Streetlight lamp manufacturer id

lamp_model

integer

Streetlight lamp model id

lamp_position

string

Lamp position

lamp_power

integer Required

Streetlight lamp power type id. Required field from product version 3.2.22

lamp_shade

integer

Streetlight lamp shade type id

lamp_socket

integer

Streetlight lamp socket type id

lamp_type

integer Required

Streetlight lamp type id

lamp_usage_class

integer

Streetlight lamp usage class id

lamp_warranty_exp_date

string

Streetlight lamp warranty expiration date

lamp_warranty_period

integer

Lamp warranty period length

lantern_angle

integer

Available from product version 3.2.22

light_change_date

string

Streetlight change date

light_checkout_date

string

Streetlight checkout date

light_condition

integer

Streetlight condition id

light_connection

integer

Streetlight connection type id

light_connection_change_date

string

Streetlight connection change date

light_distribution

integer

Streetlight distribution type id

light_manufacturer

integer

Streetlight manufacturer id

light_power

integer

Streetlight light power type id

light_specifier

integer

Streetlight specifier type id

light_warranty_exp_date

string

Streetlight warranty expiration date

light_warranty_period

integer

Streetlight warranty period length

lightning_class

integer

Streetlight lightning class id

location

string

Geographical location

location_accuracy

integer

Location accuracy id

luminaire_angle

integer

Available from product version 3.2.22

luminous_flux

integer

Luminous flux

mapper

string

mapper name

mapping_date

string

mapping date

mapping_method

integer

Mapping method id

network_area

integer

Network area id

next_group_change_date

string

Streetlight group next change date

next_group_cleaning_date

string

Streetlight group next cleaning date

owner

integer

Owner id

plan

integer

Plan id

pole

integer

Streetlight pole id

protection

integer

Streetlight protection type id. Available from product version 3.2.20.

purlin_angle

number

purlin angle

purlin_change_date

string

Streetlight purlin date

purlin_diameter

number

Purlin diameter

purlin_holder

integer

Streetlight purlin holder type id

purlin_material

integer

Streetlight purlin material id

purlin_phase

integer

Streetlight connection phase type id

purlin_saving

boolean

purlin phase saving enabled

purlin_surface

integer

Streetlight purlin surface type id

purlin_type

integer

Streetlight purlin type id

reflector_position

string

Reflector position

renter

integer

Renter id

riser

integer

Streetlight riser cable type id

riser_change_date

string

Streetlight riser change date

survey_amount

integer

unknown

update_date

string

last update date time

updated_by

string

object last updater

usage_state

integer Required

Usage state id

Responses

201

A created Streetlight

{
  "capacitor": null,
  "capacitor_change_date": null,
  "choker": null,
  "color": null,
  "color_rendering_index": null,
  "color_temperature": null,
  "contractor": null,
  "control_device": null,
  "control_profile": null,
  "cope": null,
  "cope_change_date": null,
  "creation_date": "2019-05-03T15:28:22.508898Z",
  "creator": "api@keypro.fi",
  "group_change_date": null,
  "group_cleaning_date": null,
  "height_accuracy": null,
  "id": 85511,
  "ik_class": null,
  "installation_date": null,
  "installation_height": null,
  "installation_type": null,
  "installation_year": null,
  "ip_class": null,
  "lamp_change_date": null,
  "lamp_count": null,
  "lamp_dimmer": null,
  "lamp_dimmer_change_date": null,
  "lamp_dimming_class": null,
  "lamp_lighter": null,
  "lamp_lighter_change_date": null,
  "lamp_manufacturer": null,
  "lamp_model": null,
  "lamp_position": "",
  "lamp_power": 300510,
  "lamp_shade": null,
  "lamp_socket": null,
  "lamp_type": 300750,
  "lamp_usage_class": null,
  "lamp_warranty_exp_date": null,
  "lamp_warranty_period": null,
  "light_change_date": null,
  "light_checkout_date": null,
  "light_condition": null,
  "light_connection": null,
  "light_connection_change_date": null,
  "light_distribution": null,
  "light_manufacturer": null,
  "light_power": null,
  "light_specifier": null,
  "light_warranty_exp_date": null,
  "light_warranty_period": null,
  "lightning_class": null,
  "location": null,
  "location_accuracy": null,
  "luminous_flux": null,
  "mapper": "",
  "mapping_date": null,
  "mapping_method": null,
  "network_area": null,
  "next_group_change_date": null,
  "next_group_cleaning_date": null,
  "owner": null,
  "plan": null,
  "pole": null,
  "protection": null,
  "purlin_angle": null,
  "purlin_change_date": null,
  "purlin_diameter": null,
  "purlin_holder": null,
  "purlin_material": null,
  "purlin_surface": null,
  "purlin_type": null,
  "reflector_position": "",
  "renter": null,
  "riser": null,
  "riser_change_date": null,
  "survey_amount": "",
  "update_date": "2019-05-03T15:28:22.508898Z",
  "updated_by": "api@keypro.fi",
  "usage_state": 303350
}

object

capacitor

integer

Streetlight capacitor type id

capacitor_change_date

string

Streetlight capacitor date

choker

integer

Streetlight choker type id

color

integer

Streetlight color type id

color_rendering_index

integer

Streetlight color rendering index. Available from product version 3.2.20.

color_temperature

integer

Streetlight color temperature type id

contractor

integer

Streetlight contractor id

control_device

integer

Streetlight control device type id. Available from product version 3.2.20.

control_profile

integer

Streetlight control profile type id. Available from product version 3.2.20.

cope

integer

Streetlight cope type id

cope_change_date

string

Streetlight cope change date

creation_date

string

creation date and time

creator

string

object creator

group_change_date

string

Streetlight group change date

group_cleaning_date

string

Streetlight group cleaning date

height_accuracy

integer

Height accuracy id

integer

Primary key

ik_class

integer

Streetlight IK class type id. Available from product version 3.2.20.

installation_date

string

Installation date

installation_height

number

Installation height

installation_type

integer

Streetlight installation type id

installation_year

integer

Installation year

ip_class

integer

Streetlight IP class type id. Available from product version 3.2.20.

lamp_change_date

string

Streetlight lamp change date

lamp_count

integer

Lamp count

lamp_dimmer

integer

Streetlight lamp dimmer type id

lamp_dimmer_change_date

string

Streetlight lamp dimmer change date

lamp_dimming_class

integer

Streetlight lamp dimming class id

lamp_lighter

integer

Streetlight lamp lighter type id

lamp_lighter_change_date

string

Streetlight lamp lighter checkout date

lamp_manufacturer

integer

Streetlight lamp manufacturer id

lamp_model

integer

Streetlight lamp model id

lamp_position

string

Lamp position

lamp_power

integer

Streetlight lamp power type id. Required field from product version 3.2.22

lamp_shade

integer

Streetlight lamp shade type id

lamp_socket

integer

Streetlight lamp socket type id

lamp_type

integer

Streetlight lamp type id

lamp_usage_class

integer

Streetlight lamp usage class id

lamp_warranty_exp_date

string

Streetlight lamp warranty expiration date

lamp_warranty_period

integer

Lamp warranty period length

lantern_angle

integer

Available from product version 3.2.22

light_change_date

string

Streetlight change date

light_checkout_date

string

Streetlight checkout date

light_condition

integer

Streetlight condition id

light_connection

integer

Streetlight connection type id

light_connection_change_date

string

Streetlight connection change date

light_distribution

integer

Streetlight distribution type id

light_manufacturer

integer

Streetlight manufacturer id

light_power

integer

Streetlight light power type id

light_specifier

integer

Streetlight specifier type id

light_warranty_exp_date

string

Streetlight warranty expiration date

light_warranty_period

integer

Streetlight warranty period length

lightning_class

integer

Streetlight lightning class id

location

string

Geographical location

location_accuracy

integer

Location accuracy id

luminaire_angle

integer

Available from product version 3.2.22

luminous_flux

integer

Luminous flux

mapper

string

mapper name

mapping_date

string

mapping date

mapping_method

integer

Mapping method id

network_area

integer

Network area id

next_group_change_date

string

Streetlight group next change date

next_group_cleaning_date

string

Streetlight group next cleaning date

owner

integer

Owner id

plan

integer

Plan id

pole

integer

Streetlight pole id

protection

integer

Streetlight protection type id. Available from product version 3.2.20.

purlin_angle

number

purlin angle

purlin_change_date

string

Streetlight purlin date

purlin_diameter

number

Purlin diameter

purlin_holder

integer

Streetlight purlin holder type id

purlin_material

integer

Streetlight purlin material id

purlin_phase

integer

Streetlight connection phase type id

purlin_saving

boolean

purlin phase saving enabled

purlin_surface

integer

Streetlight purlin surface type id

purlin_type

integer

Streetlight purlin type id

reflector_position

string

Reflector position

renter

integer

Renter id

riser

integer

Streetlight riser cable type id

riser_change_date

string

Streetlight riser change date

survey_amount

integer

unknown

update_date

string

last update date time

updated_by

string

object last updater

usage_state

integer

Usage state id

400

There was an error in request. Usually field validation failed.

{
  "type": [
    "This field is required."
  ],
  "usage_state": [
    "This field is required."
  ]
}

object

Fields which failed validation

401

Authentication credentials are missing or invalid

{
  "details": "Authentication credentials were not provided"
}

object

details

string

Detailed description of error

Was this article helpful?

What's Next

Delete streetlight