Configure a measuring point.

Parameters:

measuring_point_id:

The ID of the measuring point which you'd like to configure. If omitted it will create a new measuring point.

Expects the body of the request to be a JSON dictionary. Note that all values passed are expected to be in the user profiles unit of distance. Also note that it will be removed from a project if coupled to one when using the API.

The following can be set using the API

Body options:

name:

Name for the measuring point

sensor_name:

six letter name which is located on the front sticker, can be blank for no Swarm connected

postal_code (optional):

Postal code

house_number (optional):

House number

street_name (optional):

Street name

city (optional):

City

disable_led:

true or false, setting it to true will turn of the led on the front of the Swarm when there is an active connection to the server.

log_flush_interval:

Interval in seconds, when there are measurements which didn't cause an alarm they will be send at this interval.

timezone:

The timezone in which the Swarm is. One of: Pacific/Guadalcanal, Greenwich, America/Fort_Wayne, Egypt, America/Araguaina, Europe/Kirov, America/Tegucigalpa, US/Central, America/Curacao, Asia/Ust-Nera, Asia/Chungking, America/Argentina/Ushuaia, Indian/Mayotte, Kwajalein, America/Halifax, Asia/Istanbul, America/Cayenne, Asia/Qostanay, America/Kentucky/Monticello, America/St_Thomas, Africa/Dar_es_Salaam, Atlantic/Jan_Mayen, America/Rainy_River, Pacific/Auckland, America/Aruba, Canada/Eastern, America/Edmonton, America/Martinique, Antarctica/Davis, Europe/Bucharest, Asia/Dacca, Asia/Oral, Asia/Tomsk, Asia/Tel_Aviv, Etc/Zulu, Arctic/Longyearbyen, America/Scoresbysund, US/Mountain, Europe/Vaduz, Asia/Katmandu, Asia/Dhaka, America/Matamoros, Africa/Khartoum, Africa/Tunis, Europe/Prague, Australia/Perth, Europe/Zagreb, Etc/GMT-0, Antarctica/Vostok, Pacific/Kiritimati, Pacific/Wake, America/Yakutat, Pacific/Tarawa, Africa/Sao_Tome, Asia/Kathmandu, Africa/Niamey, America/Inuvik, Mexico/BajaNorte, Asia/Karachi, Asia/Kolkata, US/Aleutian, Pacific/Chuuk, US/Arizona, Europe/Guernsey, Asia/Macau, Asia/Tbilisi, Etc/UTC, America/El_Salvador, Asia/Thimbu, America/Noronha, Africa/Bamako, America/Boise, America/Cambridge_Bay, America/Thule, Asia/Srednekolymsk, Pacific/Apia, Israel, America/Bahia, Africa/Harare, NZ-CHAT, Pacific/Ponape, Asia/Baku, America/Costa_Rica, Europe/Istanbul, Asia/Choibalsan, Etc/GMT+0, Europe/Tallinn, Asia/Macao, GMT0, Eire, HST, Asia/Seoul, America/Dawson, America/Guatemala, Asia/Novosibirsk, America/Indiana/Petersburg, Australia/South, Africa/Djibouti, America/Rosario, Etc/GMT-1, EST5EDT, America/Grand_Turk, Australia/Canberra, Etc/GMT+6, Asia/Amman, America/Lima, Brazil/West, Asia/Krasnoyarsk, America/Indiana/Vevay, Australia/North, Pacific/Easter, MST, Africa/Mbabane, Navajo, Asia/Qyzylorda, Pacific/Truk, Europe/Gibraltar, Etc/Universal, Pacific/Wallis, America/Moncton, Atlantic/Stanley, America/Argentina/Tucuman, Australia/Lindeman, Iceland, Europe/Zurich, America/Porto_Acre, Africa/Abidjan, Antarctica/Mawson, Asia/Baghdad, Asia/Hovd, Turkey, Europe/Helsinki, Asia/Nicosia, Europe/Budapest, Europe/Sofia, Asia/Aden, Atlantic/Azores, Australia/Melbourne, Indian/Chagos, Indian/Maldives, Etc/GMT-11, UTC, Pacific/Kwajalein, America/Guyana, America/Pangnirtung, Indian/Reunion, America/Iqaluit, Asia/Omsk, Asia/Phnom_Penh, Pacific/Guam, Africa/El_Aaiun, Etc/GMT, Etc/GMT+12, America/Glace_Bay, Poland, America/Knox_IN, Pacific/Efate, Etc/GMT+11, US/Samoa, America/Metlakatla, Etc/GMT0, America/Paramaribo, NZ, America/Tijuana, Pacific/Rarotonga, Pacific/Tahiti, America/Argentina/San_Luis, Pacific/Kanton, Europe/Ulyanovsk, Pacific/Chatham, Pacific/Fiji, PST8PDT, Etc/GMT+4, US/Indiana-Starke, Asia/Damascus, America/Indiana/Winamac, Etc/GMT-8, Indian/Antananarivo, Asia/Barnaul, Etc/GMT-12, America/Indiana/Indianapolis, America/North_Dakota/New_Salem, Europe/Kiev, Asia/Chita, Mexico/General, America/Montevideo, Asia/Manila, America/Santo_Domingo, Universal, America/Atikokan, Pacific/Noumea, Europe/Jersey, Asia/Irkutsk, Indian/Mahe, Etc/GMT+10, America/New_York, America/Vancouver, Antarctica/Macquarie, Europe/Vilnius, Atlantic/Faeroe, Indian/Comoro, Africa/Bujumbura, America/Dawson_Creek, Etc/Greenwich, Pacific/Fakaofo, America/Goose_Bay, America/Marigot, America/Anguilla, Europe/Astrakhan, Asia/Dubai, Europe/Brussels, Europe/Isle_of_Man, Africa/Porto-Novo, Africa/Kigali, America/Port-au-Prince, Pacific/Pago_Pago, America/Panama, America/Antigua, Africa/Ouagadougou, Canada/Atlantic, America/Bahia_Banderas, Europe/Vienna, America/Kentucky/Louisville, Africa/Maputo, Antarctica/Casey, Asia/Pontianak, Etc/GMT-5, America/Santiago, America/Belize, Africa/Bissau, Asia/Jakarta, America/Mendoza, Asia/Saigon, Africa/Bangui, America/Blanc-Sablon, Etc/GMT+9, America/Chihuahua, Atlantic/Faroe, Africa/Algiers, Canada/Central, Africa/Johannesburg, Europe/Podgorica, America/Argentina/Cordoba, Asia/Almaty, Australia/Yancowinna, Australia/Currie, ROK, Etc/GMT-13, Pacific/Bougainville, Canada/Yukon, Asia/Ashkhabad, America/Regina, Asia/Jerusalem, Etc/GMT-7, Hongkong, America/Thunder_Bay, America/Caracas, Asia/Gaza, Europe/Sarajevo, Africa/Timbuktu, America/Belem, America/Nuuk, Asia/Jayapura, Pacific/Kosrae, America/Argentina/San_Juan, America/Ojinaga, WET, Pacific/Yap, Africa/Ceuta, Africa/Luanda, Europe/Mariehamn, Asia/Tokyo, America/Montserrat, America/Jamaica, America/Asuncion, Asia/Yekaterinburg, Atlantic/St_Helena, Asia/Chongqing, Europe/Warsaw, Europe/Moscow, Australia/Victoria, CST6CDT, Africa/Kinshasa, America/Atka, America/Menominee, Australia/Hobart, Africa/Nairobi, Asia/Vientiane, Mexico/BajaSur, Singapore, Asia/Bangkok, Europe/Oslo, America/Santa_Isabel, Asia/Famagusta, Africa/Asmara, Africa/Tripoli, Europe/Uzhgorod, Africa/Douala, Etc/GMT-9, America/Anchorage, America/Adak, America/Fort_Nelson, Japan, America/Nipigon, Etc/GMT-14, Cuba, Pacific/Enderbury, Etc/GMT-2, Europe/Samara, Asia/Dili, America/Indianapolis, Asia/Anadyr, Antarctica/Rothera, GMT+0, Asia/Sakhalin, Antarctica/McMurdo, Etc/GMT-6, GMT-0, America/Nassau, Canada/Saskatchewan, MST7MDT, America/Indiana/Tell_City, Asia/Dushanbe, MET, Etc/GMT+7, Europe/Athens, Asia/Singapore, Asia/Ujung_Pandang, Europe/Riga, America/Creston, Asia/Pyongyang, America/Guayaquil, Antarctica/DumontDUrville, Asia/Riyadh, GB, America/St_Vincent, America/Montreal, Australia/Lord_Howe, Africa/Libreville, Africa/Freetown, Asia/Bahrain, America/St_Kitts, Europe/Berlin, US/Eastern, America/Managua, Europe/London, GMT, US/Pacific, Indian/Kerguelen, Europe/Monaco, America/Boa_Vista, Asia/Vladivostok, America/Phoenix, PRC, Asia/Samarkand, America/Argentina/Catamarca, Asia/Aqtobe, Atlantic/Madeira, Asia/Kashgar, Australia/West, Asia/Ashgabat, Asia/Urumqi, Europe/Luxembourg, America/Nome, America/Miquelon, Pacific/Johnston, America/Yellowknife, Asia/Taipei, ROC, America/Catamarca, America/Mexico_City, America/Port_of_Spain, W-SU, America/Punta_Arenas, Atlantic/South_Georgia, America/Shiprock, Europe/Amsterdam, Etc/GMT-10, Europe/Rome, Australia/NSW, Pacific/Gambier, America/Argentina/Salta, Europe/Stockholm, Europe/Skopje, Europe/Vatican, Australia/Adelaide, Iran, Asia/Yerevan, America/Cayman, America/Indiana/Vincennes, America/Sitka, Etc/GMT+5, Africa/Asmera, America/Cancun, Europe/San_Marino, Africa/Accra, America/Argentina/Rio_Gallegos, CET, Canada/Pacific, Europe/Dublin, America/Indiana/Knox, America/Fortaleza, America/Maceio, Libya, Africa/Lome, Asia/Atyrau, Africa/Casablanca, America/Toronto, America/Guadeloupe, Asia/Ulan_Bator, Europe/Paris, Europe/Saratov, Pacific/Nauru, America/Chicago, Africa/Gaborone, Pacific/Tongatapu, Antarctica/Troll, America/Resolute, Chile/Continental, Europe/Zaporozhye, America/Santarem, Africa/Windhoek, America/Winnipeg, Pacific/Port_Moresby, Europe/Kaliningrad, Australia/Eucla, Pacific/Honolulu, Antarctica/Palmer, Australia/Queensland, Zulu, America/Puerto_Rico, Africa/Nouakchott, Etc/GMT+1, America/Buenos_Aires, Africa/Dakar, America/Argentina/La_Rioja, Antarctica/South_Pole, America/Argentina/Jujuy, Australia/Darwin, Australia/LHI, Pacific/Niue, Etc/GMT-4, Canada/Mountain, America/North_Dakota/Center, America/Coral_Harbour, US/Michigan, America/Lower_Princes, America/Rankin_Inlet, Asia/Calcutta, Europe/Madrid, Australia/ACT, Etc/GMT+8, America/Argentina/Mendoza, Africa/Conakry, Africa/Brazzaville, Europe/Bratislava, America/La_Paz, Australia/Sydney, Etc/UCT, America/Ensenada, Africa/Malabo, Etc/GMT-3, America/Jujuy, Europe/Copenhagen, America/Virgin, Asia/Makassar, Asia/Kabul, Atlantic/Canary, America/Merida, Africa/Monrovia, Europe/Andorra, Europe/Tirane, Africa/Lusaka, Asia/Muscat, Asia/Kuala_Lumpur, Asia/Ulaanbaatar, Africa/Blantyre, Pacific/Norfolk, Pacific/Funafuti, Antarctica/Syowa, America/Denver, Brazil/Acre, America/Godthab, US/Alaska, GB-Eire, Australia/Tasmania, Asia/Beirut, Asia/Tashkent, Indian/Cocos, America/Juneau, America/Recife, Asia/Hong_Kong, America/Barbados, Asia/Brunei, Etc/GMT+2, America/Tortola, Asia/Bishkek, Asia/Aqtau, Pacific/Galapagos, America/Kralendijk, Asia/Yangon, America/Argentina/ComodRivadavia, Africa/Addis_Ababa, Asia/Kuching, Europe/Nicosia, Pacific/Marquesas, Portugal, Europe/Belgrade, UCT, Africa/Lagos, America/Havana, Asia/Rangoon, Indian/Mauritius, Europe/Lisbon, US/Hawaii, Asia/Kamchatka, Asia/Kuwait, Chile/EasterIsland, Pacific/Majuro, America/Bogota, Europe/Minsk, Australia/Broken_Hill, Atlantic/Cape_Verde, Europe/Tiraspol, Canada/Newfoundland, Atlantic/Reykjavik, Pacific/Pohnpei, Asia/Tehran, America/Rio_Branco, Europe/Ljubljana, Pacific/Pitcairn, Europe/Malta, America/Porto_Velho, America/Manaus, Brazil/East, America/Mazatlan, America/St_Johns, Asia/Qatar, Asia/Thimphu, Africa/Banjul, America/St_Barthelemy, Pacific/Midway, Africa/Lubumbashi, Asia/Novokuznetsk, America/Detroit, America/Whitehorse, Europe/Belfast, America/Cordoba, America/Los_Angeles, Europe/Simferopol, Etc/GMT+3, Pacific/Palau, America/Argentina/Buenos_Aires, America/Grenada, America/Campo_Grande, Europe/Chisinau, Europe/Volgograd, Indian/Christmas, Pacific/Saipan, America/Swift_Current, Asia/Magadan, Atlantic/Bermuda, Asia/Hebron, America/Indiana/Marengo, America/North_Dakota/Beulah, Asia/Khandyga, Africa/Maseru, America/Monterrey, Asia/Colombo, Jamaica, EET, America/Cuiaba, Asia/Ho_Chi_Minh, Europe/Busingen, America/Dominica, America/Louisville, Asia/Harbin, America/Sao_Paulo, Africa/Juba, Africa/Cairo, America/Danmarkshavn, Asia/Yakutsk, America/Hermosillo, EST, Africa/Ndjamena, Australia/Brisbane, Africa/Kampala, Brazil/DeNoronha, US/East-Indiana, America/Eirunepe, Pacific/Samoa, America/St_Lucia, Africa/Mogadishu, Asia/Shanghai

guide_line:

One of: Circulaire86, ISEE_250Hz, IN1226, SBR_A_2017, SS_025211, SN640312a, SS_4604861, SBR_A_2010, ONORM_S_9020, UNE_22_381_93, DIN4150_2, BS7385_250Hz, DIN4150_3_80Hz, SBR_B_2002

category (optional):

One of: CAT1, CAT3, CAT2

building_level:

One of: buildingClass1, USBM_RI8507_drywall, selfDefined, lowerLevel, floorSlabs, undergroundCavities, pipeline, buildingClass2, buildingClass5, guidelineValues, buildingClass3, unspecified, buildingClass4, OSMRE_1983, freshConcrete, highestFloor, USBM_RI8507_plaster, dinFoundation, foundation, structure

flat_level:

Only available when the building_level is set to unspecified. This will be an absolute value as alarm level.

vector_enabled:

Off, On, setting it to On will store the PVS (peak vector sum) and also trigger (non frequency dependend) alarms based on PVS.

vdv_enabled:

Off, On, setting it to On will calculate and store VDV (vibration dose value)

atop_enabled:

Off, On, setting it to On will calculate and store PPA (peak particle acceleration)

vtop_enabled:

Off, On, setting it to Off will prevent calculating and storing PPV (peak particle acceleration)

vdv_period:

Will be used as the measurement duration for calculating VDV

vdv_x:

One of: BS6841_Wf, ISO2631_Wf, ISO8041_Wh, ISO2631_Wc, ISO2631_Wm, ISO5349_Wh, ISO2631_Wk, BS6841_We, BS6841_Wc, BS6841_Wb, ISO2631_We, BS6841_Wg, ISO2631_Wd, ISO2631_Wj, BS6841_Wd

vdv_y:

One of: BS6841_Wf, ISO2631_Wf, ISO8041_Wh, ISO2631_Wc, ISO2631_Wm, ISO5349_Wh, ISO2631_Wk, BS6841_We, BS6841_Wc, BS6841_Wb, ISO2631_We, BS6841_Wg, ISO2631_Wd, ISO2631_Wj, BS6841_Wd

vdv_z:

One of: BS6841_Wf, ISO2631_Wf, ISO8041_Wh, ISO2631_Wc, ISO2631_Wm, ISO5349_Wh, ISO2631_Wk, BS6841_We, BS6841_Wc, BS6841_Wb, ISO2631_We, BS6841_Wg, ISO2631_Wd, ISO2631_Wj, BS6841_Wd

measuring_type:

Needed with SBR, DIN 4150-3 and Circulaire86 measurements. One of indicative, extensive, limited

concrete_setting_level

Used with IN 1226. One of lessThan10MPa, moreThan15MPa, rc10MPaTo15MPa, lessThan2hours

vibration_source

Used with IN 1226. One of pilingSheetingExcavation, blasting, compaction, mechanicalDevices

vibration_type:

Needed with SBR, DIN 4150-3 and Circulaire86 measurements. One of repeated, shortTerm, impulsive, momentarily, continually, continuous, peak, longTerm

building_state:

Needed with SBR 2017. One of normal, sensitive

zet_gev_laagdikte:

Needed with SBR 2017 when the category is foundation. One of H_6m, H_7m, H_1m, H_2m, H_4m, H_8m, H_3m, H_5m

lining_material:

One of: concreteAndStone, materialClass2, reinforcedConcreteAndTubing, materialClass1, materialClass4, masonry, materialClass3

construction_type:

One of: designClass2, structureType3, designClass1, platformAndCatenaryPost, sensitiveConstruction, verySensitiveConstruction, structureType1, structureType2, resistantConstruction, designClass3

pipeline_type:

One of: brickworkAndPlastic, weldedSteel, concreteAndSteel

data_save_level:

float number in mm/s, threshold for storing measurement samples

measurement_duration:

Interval in seconds, at this interval samples will be taken

trace_save_level:

float number in mm/s, threshold for storing traces

trace_pre_trigger:

float number in seconds: when trace_save_level was passed how many seconds before are included in the trace

trace_post_trigger:

float number in seconds: when trace_save_level was passed how many seconds after are included in the trace

alarm_level_1:

int number in percentage: percentage of the guideline which will cause an alarm for group 1

alarm_level_2:

int number in percentage: percentage of the guideline which will cause an alarm for group 2

alarm_level_3:

int number in percentage: percentage of the guideline which will cause an alarm for group 3

email_delay:

int number in seconds: how much time will there be between two e-mails

alarm_recipients:

a list of lists containing 3 strings: where the first element is the type, the second element the value for the type and the last element which alarm level should trigger sending the notification.

webhook_recipient (optional):

an extra recipient that sends alarm notifications to a webhook. The webhook will send POST requests with a UTF-8-encoded JSON body containing the notification info. The secret provided combined with the request body will be hashed using HMAC sha-256. The hash will be placed inside of the http-header: X-Omnidots-Notifier-Signature. Make sure to calculate the hash on the receiving end as well and to compare these hashes.

There will be some variation between the different types and categories of notifications but all of them will atleast contain the following information:

{
    "measuring_point_id": 1337,
    "category": "sensor_went_online",
    "level": "success",
    "created_at": 1618488056.925577,
    "data": { "sensor": "HOSEVE", "datetime": 1618488056.922907 },
    "text": "Your Swarm HOSEVE went online on April 15, 2021, 2:00:56 p.m. CEST."
}

enable_time_[0-6]:

Scheduled start time of the Swarm, note that 0 is Sunday

disable_time_[0-6]:

Scheduled end time of the Swarm, note that 0 is Sunday

Example body:

{
    "name": "Test 123",
    "sensor_name": "BANANA"
    "postal_code": "1234 AB",
    "house_number": 56,
    "street_name": "Test road",
    "city": "Awesome town",
    "disable_led": true,
    "log_flush_interval": 60,
    "timezone": "Europe/Amsterdam",
    "guide_line": "SBR_A",
    "category": "CAT1",
    "measuring_type": "Extensive",
    "vibration_type": "Repeated",
    "data_save_level": 0.2,
    "measurement_duration": 2.0,
    "trace_save_level": 10.0,
    "trace_pre_trigger": 3.0,
    "trace_post_trigger": 3.0,
    "alarm_level_1": 90,
    "alarm_level_2": 100,
    "alarm_level_3": 100,
    "email_delay": 120,
    "alarm_recipients": [
        ["phone_number", "+31850070336", "alarm_level_3"],
        ["phone_number", "+31850070336", "measuring_point_administrator"],
        ["email", "info@omnidots.com", "alarm_level_1"]
    ],
    "webhook_recipient": {
        "url": "https://your-web-address.domain/webhook",
        "secret": "high-entropy-secret-0l25a9df7d8afd5ec",
        "alarm_level_1": false,
        "alarm_level_2": false,
        "alarm_level_3": false,
        "measuring_point_administrator": true
    },
    "enable_time_0": "00:00:00",
    "disable_time_0": "23:59:59",
    "enable_time_1": "00:08:00",
    "disable_time_1": "18:00:00",
    "enable_time_2": "00:00:00",
    "disable_time_2": "23:59:59",
    "enable_time_3": "00:00:00",
    "disable_time_3": "23:59:59",
    "enable_time_4": "00:00:00",
    "disable_time_4": "23:59:59",
    "enable_time_5": "00:00:00",
    "disable_time_5": "23:59:59",
    "enable_time_6": "00:00:00",
    "disable_time_6": "23:59:59",
}

Available API endpoints: