diff --git a/.apigentools-info b/.apigentools-info index 81defa2..23dc3a8 100644 --- a/.apigentools-info +++ b/.apigentools-info @@ -4,8 +4,8 @@ "spec_versions": { "v2": { "apigentools_version": "1.1.0", - "regenerated": "2024-01-31 14:22:44.701510", - "spec_repo_commit": "138c42b" + "regenerated": "2024-07-03 08:17:44.318130", + "spec_repo_commit": "647c963" } } } \ No newline at end of file diff --git a/index.html b/index.html index 0c81177..55a95cb 100644 --- a/index.html +++ b/index.html @@ -893,6 +893,30 @@ } }, "description" : "compressed contains the info from which to generate the certificate (default view)" +}; + defs["ArduinoCredentialsv1"] = { + "title" : "Mediatype identifier: application/vnd.arduino.credentialsv1+json; view=default", + "required" : [ "friendly_name", "required", "secret_name", "sensitive" ], + "type" : "object", + "properties" : { + "friendly_name" : { + "type" : "string", + "description" : "Friendly name" + }, + "required" : { + "type" : "boolean", + "description" : "Tell if the parameter is required or not" + }, + "secret_name" : { + "type" : "string", + "description" : "The secret parameter name" + }, + "sensitive" : { + "type" : "boolean", + "description" : "Tell if the field is sensitive" + } + }, + "description" : "ArduinoCredentialsv1 media type (default view)" }; defs["ArduinoDashboardowner"] = { "title" : "Mediatype identifier: application/vnd.arduino.dashboardowner+json; view=default", @@ -972,6 +996,10 @@ "required" : [ "name" ], "type" : "object", "properties" : { + "id" : { + "type" : "string", + "description" : "The friendly ID of the dashboard" + }, "name" : { "type" : "string", "description" : "The friendly name of the dashboard" @@ -990,7 +1018,7 @@ "connection_type" : { "type" : "string", "description" : "The type of the connections selected by the user when multiple connections are available", - "enum" : [ "wifi", "eth", "wifiandsecret", "gsm", "nb", "lora" ] + "enum" : [ "wifi", "eth", "wifiandsecret", "gsm", "nb", "lora", "catm1", "cellular" ] }, "created_at" : { "type" : "string", @@ -1151,6 +1179,31 @@ } }, "description" : "ArduinoDevicev2EventProperties media type (default view)" +}; + defs["ArduinoDevicev2Otaupload"] = { + "title" : "Mediatype identifier: application/vnd.arduino.devicev2.otaupload+json; view=default", + "required" : [ "ota_version" ], + "type" : "object", + "properties" : { + "file_sha" : { + "type" : "string", + "description" : "SHA256 of the uploaded file" + }, + "ota_id" : { + "type" : "string", + "description" : "OTA request id (only available from OTA version 2 and above)" + }, + "ota_version" : { + "type" : "integer", + "description" : "OTA version", + "format" : "int64" + }, + "status" : { + "type" : "string", + "description" : "OTA request status (only available from OTA version 2 and above)" + } + }, + "description" : "ArduinoDevicev2Otaupload media type (default view)" }; defs["ArduinoDevicev2Pass"] = { "title" : "Mediatype identifier: application/vnd.arduino.devicev2.pass+json; view=default", @@ -1379,6 +1432,21 @@ "type" : "string" } } +}; + defs["ArduinoDevicev2templatedevice"] = { + "title" : "Mediatype identifier: application/vnd.arduino.devicev2templatedevice+json; view=default", + "type" : "object", + "properties" : { + "fqbn" : { + "type" : "string", + "description" : "The device fqbn" + }, + "name" : { + "type" : "string", + "description" : "The device type name" + } + }, + "description" : "ArduinoDevicev2templatedevice media type (default view)" }; defs["ArduinoLinkedvariable"] = { "title" : "Mediatype identifier: application/vnd.arduino.linkedvariable+json; view=default", @@ -1610,6 +1678,26 @@ } }, "description" : "ArduinoSeriesBatch media type (default view)" +}; + defs["ArduinoSeriesBatchSampled"] = { + "title" : "Mediatype identifier: application/vnd.arduino.series.batch.sampled+json; view=default", + "required" : [ "resp_version", "responses" ], + "type" : "object", + "properties" : { + "resp_version" : { + "type" : "integer", + "description" : "Response version", + "format" : "int64" + }, + "responses" : { + "type" : "array", + "description" : "Responses of the request", + "items" : { + "$ref" : "#/components/schemas/ArduinoSeriesSampledResponse" + } + } + }, + "description" : "ArduinoSeriesBatchSampled media type (default view)" }; defs["ArduinoSeriesRawBatch"] = { "title" : "Mediatype identifier: application/vnd.arduino.series.raw.batch+json; view=default", @@ -1825,6 +1913,70 @@ } }, "description" : "ArduinoSeriesResponse media type (default view)" +}; + defs["ArduinoSeriesSampledResponse"] = { + "title" : "Mediatype identifier: application/vnd.arduino.series.sampled.response+json; view=default", + "required" : [ "count_values", "from_date", "interval", "query", "resp_version", "status", "times", "to_date", "values" ], + "type" : "object", + "properties" : { + "count_values" : { + "type" : "integer", + "description" : "Total number of values in the array 'values'", + "format" : "int64" + }, + "from_date" : { + "type" : "string", + "description" : "From date", + "format" : "date-time" + }, + "interval" : { + "type" : "integer", + "description" : "Resolution in seconds", + "format" : "int64" + }, + "message" : { + "type" : "string", + "description" : "If the response is different than 'ok'", + "default" : "" + }, + "query" : { + "type" : "string", + "description" : "Query of for the data" + }, + "resp_version" : { + "type" : "integer", + "description" : "Response version", + "format" : "int64" + }, + "series_limit" : { + "type" : "integer", + "description" : "Maximum number of values returned after data aggregation, if any", + "format" : "int64" + }, + "status" : { + "type" : "string", + "description" : "Status of the response" + }, + "times" : { + "type" : "array", + "description" : "Timestamp in RFC3339", + "items" : { + "type" : "string", + "format" : "date-time" + } + }, + "to_date" : { + "type" : "string", + "description" : "To date", + "format" : "date-time" + }, + "values" : { + "type" : "array", + "description" : "Values in Float", + "items" : { } + } + }, + "description" : "ArduinoSeriesSampledResponse media type (default view)" }; defs["ArduinoTags"] = { "title" : "Mediatype identifier: application/vnd.arduino.tags+json; view=default", @@ -1839,12 +1991,41 @@ } }, "description" : "ArduinoTags media type (default view)" +}; + defs["ArduinoTemplate"] = { + "title" : "Mediatype identifier: application/vnd.arduino.template+json; view=default", + "required" : [ "things" ], + "type" : "object", + "properties" : { + "dashboards" : { + "type" : "array", + "items" : { + "type" : "string", + "format" : "uuid" + } + }, + "things" : { + "$ref" : "#/components/schemas/ArduinoThingresultCollection" + }, + "triggers" : { + "type" : "array", + "items" : { + "type" : "string", + "format" : "uuid" + } + } + }, + "description" : "ArduinoTemplate media type (default view)" }; defs["ArduinoTemplateproperty"] = { "title" : "Mediatype identifier: application/vnd.arduino.templateproperty+json; view=default", "required" : [ "name", "permission", "type", "update_strategy" ], "type" : "object", "properties" : { + "id" : { + "type" : "string", + "description" : "The friendly id of the property" + }, "name" : { "type" : "string", "description" : "The friendly name of the property" @@ -1909,6 +2090,11 @@ "required" : [ "href", "id", "name", "timezone", "user_id" ], "type" : "object", "properties" : { + "assistant" : { + "type" : "string", + "description" : "The kind of voice assistant the thing is connected to, it can be ALEXA | GOOGLE | NONE", + "enum" : [ "ALEXA", "GOOGLE", "NONE" ] + }, "created_at" : { "type" : "string", "description" : "Creation date of the thing", @@ -1996,12 +2182,42 @@ } }, "description" : "ArduinoThing media type (default view)" +}; + defs["ArduinoThingresult"] = { + "title" : "Mediatype identifier: application/vnd.arduino.thingresult+json; view=default", + "required" : [ "id", "sketch_id" ], + "type" : "object", + "properties" : { + "device_id" : { + "type" : "string", + "description" : "UUID of the attached device", + "format" : "uuid" + }, + "id" : { + "type" : "string", + "description" : "UUID of the created Thing", + "format" : "uuid" + }, + "sketch_id" : { + "type" : "string", + "description" : "UUID of the created Sketch", + "format" : "uuid" + } + }, + "description" : "ArduinoThingresult media type (default view)" }; defs["ArduinoThingtemplate"] = { "title" : "Mediatype identifier: application/vnd.arduino.thingtemplate+json; view=default", "required" : [ "name", "timezone" ], "type" : "object", "properties" : { + "device_metadata" : { + "$ref" : "#/components/schemas/ArduinoDevicev2templatedevice" + }, + "id" : { + "type" : "string", + "description" : "The friendly id of the thing" + }, "name" : { "type" : "string", "description" : "The friendly name of the thing" @@ -2011,8 +2227,9 @@ "description" : "Id of the organization the thing belongs to", "format" : "uuid" }, - "properties" : { - "$ref" : "#/components/schemas/ArduinoTemplatepropertyCollection" + "sketch_template" : { + "type" : "string", + "description" : "The ID of the template's sketch" }, "tags" : { "type" : "array", @@ -2025,6 +2242,9 @@ "type" : "string", "description" : "Time zone of the thing" }, + "variables" : { + "$ref" : "#/components/schemas/ArduinoTemplatepropertyCollection" + }, "webhook_uri" : { "type" : "string", "description" : "Webhook uri" @@ -2127,8 +2347,7 @@ }, "type" : { "type" : "string", - "description" : "The type of the widget", - "enum" : [ "slider, gauge" ] + "description" : "The type of the widget" }, "variables" : { "$ref" : "#/components/schemas/ArduinoLinkedvariableCollection" @@ -2378,6 +2597,58 @@ "format" : "int64" } } +}; + defs["BatchQuerySampledRequestMediaV1"] = { + "title" : "BatchQuerySampledRequestMediaV1", + "required" : [ "q" ], + "type" : "object", + "properties" : { + "from" : { + "type" : "string", + "description" : "From timestamp (default: now UTC - 24h)", + "format" : "date-time" + }, + "interval" : { + "maximum" : 86400, + "minimum" : 60, + "type" : "integer", + "description" : "Resolution in seconds (allowed min:60, max:86400)", + "default" : 300 + }, + "q" : { + "type" : "string", + "description" : "Data selection query (e.g. property.2a99729d-2556-4220-a139-023348a1e6b5)" + }, + "series_limit" : { + "type" : "integer", + "description" : "Maximum number of values returned after data aggregation, if any (default: 300, limit: 1000)", + "format" : "int64" + }, + "to" : { + "type" : "string", + "description" : "To timestamp (default: now UTC)", + "format" : "date-time" + } + } +}; + defs["BatchQuerySampledRequestsMediaV1"] = { + "title" : "BatchQuerySampledRequestsMediaV1", + "required" : [ "requests", "resp_version" ], + "type" : "object", + "properties" : { + "requests" : { + "type" : "array", + "description" : "Requests", + "items" : { + "$ref" : "#/components/schemas/BatchQuerySampledRequestMediaV1" + } + }, + "resp_version" : { + "type" : "integer", + "description" : "Response version", + "format" : "int64" + } + } }; defs["CheckDevicesV2PassPayload"] = { "title" : "CheckDevicesV2PassPayload", @@ -2432,7 +2703,7 @@ "connection_type" : { "type" : "string", "description" : "The type of the connections selected by the user when multiple connections are available", - "enum" : [ "wifi", "eth", "wifiandsecret", "gsm", "nb", "lora" ] + "enum" : [ "wifi", "eth", "wifiandsecret", "gsm", "nb", "lora", "catm1", "cellular" ] }, "fqbn" : { "type" : "string", @@ -2559,7 +2830,7 @@ "connection_type" : { "type" : "string", "description" : "The type of the connections selected by the user when multiple connections are available", - "enum" : [ "wifi", "eth", "wifiandsecret", "gsm", "nb", "lora" ] + "enum" : [ "wifi", "eth", "wifiandsecret", "gsm", "nb", "lora", "catm1", "cellular" ] }, "fqbn" : { "type" : "string", @@ -2638,6 +2909,27 @@ "default" : 10 } } +}; + defs["devicev2.otaurlpyalod"] = { + "title" : "devicev2.otaurlpyalod", + "type" : "object", + "properties" : { + "binary_key" : { + "pattern" : "^ota/[a-zA-Z0-9_-]+/[a-zA-Z0-9_-]+.ota$", + "type" : "string", + "description" : "The object key of the binary" + }, + "sha256" : { + "pattern" : "^[a-fA-F0-9]{64}$", + "type" : "string", + "description" : "The sha256 of the binary" + }, + "user_id" : { + "type" : "string", + "description" : "The id of the user who is requesting the url", + "format" : "uuid" + } + } }; defs["devicev2.pass"] = { "title" : "devicev2.pass", @@ -2868,6 +3160,33 @@ "description" : "Value of the tag" } } +}; + defs["template"] = { + "title" : "template", + "required" : [ "template_name" ], + "type" : "object", + "properties" : { + "custom_template_id" : { + "type" : "string", + "description" : "The name of the directory on S3 bucket containing the user's template" + }, + "prefix_name" : { + "maxLength" : 45, + "pattern" : "^[a-zA-Z0-9_. -]+$", + "type" : "string", + "description" : "The prefix to apply to the names of the generated resources" + }, + "template_name" : { + "type" : "string", + "description" : "The name of the directory on S3 bucket containing the template", + "example" : "remote-controlled-lights" + }, + "things_options" : { + "type" : "object", + "additionalProperties" : true + } + }, + "description" : "TemplatePayload describes the needed attribute to apply a template" }; defs["ThingClone"] = { "title" : "ThingClone", @@ -2880,7 +3199,7 @@ }, "name" : { "maxLength" : 64, - "pattern" : "^[a-zA-Z0-9_.@ -]+$", + "pattern" : "^[a-zA-Z0-9_. -]+$", "type" : "string", "description" : "The friendly name of the thing" } @@ -2891,68 +3210,11 @@ "title" : "ThingCreate", "type" : "object", "properties" : { - "device_id" : { + "assistant" : { "type" : "string", - "description" : "The arn of the associated device", - "format" : "uuid" + "description" : "The kind of voice assistant the thing is connected to, it can be ALEXA | GOOGLE | NONE", + "enum" : [ "ALEXA", "GOOGLE", "NONE" ] }, - "id" : { - "type" : "string", - "description" : "The id of the thing", - "format" : "uuid" - }, - "name" : { - "maxLength" : 64, - "pattern" : "^[a-zA-Z0-9_.@ -]+$", - "type" : "string", - "description" : "The friendly name of the thing" - }, - "properties" : { - "type" : "array", - "description" : "The properties of the thing", - "items" : { - "$ref" : "#/components/schemas/property" - } - }, - "tags" : { - "type" : "array", - "description" : "Optional set of tags", - "items" : { - "$ref" : "#/components/schemas/tag" - } - }, - "timezone" : { - "type" : "string", - "description" : "A time zone name\nCheck /v2/timezones for a list of valid names.", - "default" : "America/New_York" - }, - "webhook_active" : { - "type" : "boolean", - "description" : "Webhook uri" - }, - "webhook_uri" : { - "type" : "string", - "description" : "Webhook uri" - } - }, - "description" : "Payload to create a new thing" -}; - defs["thingSketch"] = { - "title" : "thingSketch", - "type" : "object", - "properties" : { - "sketch_version" : { - "type" : "string", - "description" : "The autogenerated sketch version", - "enum" : [ "v1", "v2" ] - } - }, - "description" : "ThingSketchPayload describes a sketch of a thing" -}; - defs["thingUpdate"] = { - "title" : "thingUpdate", - "type" : "object", - "properties" : { "device_id" : { "type" : "string", "description" : "The arn of the associated device", @@ -2965,7 +3227,74 @@ }, "name" : { "maxLength" : 64, - "pattern" : "^[a-zA-Z0-9_.@ -]+$", + "pattern" : "^[a-zA-Z0-9_. -]+$", + "type" : "string", + "description" : "The friendly name of the thing" + }, + "properties" : { + "type" : "array", + "description" : "The properties of the thing", + "items" : { + "$ref" : "#/components/schemas/property" + } + }, + "tags" : { + "type" : "array", + "description" : "Optional set of tags", + "items" : { + "$ref" : "#/components/schemas/tag" + } + }, + "timezone" : { + "type" : "string", + "description" : "A time zone name\nCheck /v2/timezones for a list of valid names.", + "default" : "America/New_York" + }, + "webhook_active" : { + "type" : "boolean", + "description" : "Webhook uri" + }, + "webhook_uri" : { + "type" : "string", + "description" : "Webhook uri" + } + }, + "description" : "Payload to create a new thing" +}; + defs["thingSketch"] = { + "title" : "thingSketch", + "type" : "object", + "properties" : { + "sketch_version" : { + "type" : "string", + "description" : "The autogenerated sketch version", + "enum" : [ "v1", "v2" ] + } + }, + "description" : "ThingSketchPayload describes a sketch of a thing" +}; + defs["thingUpdate"] = { + "title" : "thingUpdate", + "type" : "object", + "properties" : { + "assistant" : { + "type" : "string", + "description" : "The kind of voice assistant the thing is connected to, it can be ALEXA | GOOGLE | NONE", + "enum" : [ "ALEXA", "GOOGLE", "NONE" ] + }, + "device_id" : { + "type" : "string", + "description" : "The arn of the associated device", + "format" : "uuid" + }, + "id" : { + "type" : "string", + "description" : "The id of the thing", + "format" : "uuid" + }, + "name" : { + "maxLength" : 64, + "pattern" : "^[a-zA-Z0-9_. -]+$", "type" : "string", "description" : "The friendly name of the thing" }, @@ -3214,6 +3543,9 @@
  • devicesV2OtaUpload
  • +
  • + devicesV2OtaUrl +
  • devicesV2PassCheck @@ -3245,6 +3577,13 @@
  • loraFreqPlanV1List
  • + +
  • + networkCredentialsV1Show +
  • +
  • + networkCredentialsV1ShowByDevice +
  • propertiesV2Create @@ -3277,9 +3616,16 @@
  • seriesV2BatchQueryRawLastValue
  • +
  • + seriesV2BatchQuerySampling +
  • seriesV2HistoricData
  • + +
  • + templatesApply +
  • thingsV2Clone @@ -20766,7 +21112,7 @@

    Usage and SDK Samples

    curl -X POST \
      \
    - -H "Accept: application/vnd.goa.error+json,text/plain" \
    + -H "Accept: application/vnd.arduino.devicev2.otaupload+json,application/vnd.goa.error+json" \
      -H "Content-Type: multipart/form-data" \
      "https://api2.arduino.cc/iot/v2/devices/{id}/ota"
     
    @@ -20796,7 +21142,8 @@

    Usage and SDK Samples

    Integer expireInMins = 56; // Integer | Binary expire time in minutes, default 10 mins try { - apiInstance.devicesV2OtaUpload(id, otaFile, async, expireInMins); + ArduinoDevicev2Otaupload result = apiInstance.devicesV2OtaUpload(id, otaFile, async, expireInMins); + System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling DevicesV2OtaApi#devicesV2OtaUpload"); e.printStackTrace(); @@ -20838,7 +21185,8 @@

    Usage and SDK Samples

    Integer expireInMins = 56; // Integer | Binary expire time in minutes, default 10 mins try { - apiInstance.devicesV2OtaUpload(id, otaFile, async, expireInMins); + ArduinoDevicev2Otaupload result = apiInstance.devicesV2OtaUpload(id, otaFile, async, expireInMins); + System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling DevicesV2OtaApi#devicesV2OtaUpload"); e.printStackTrace(); @@ -20869,7 +21217,10 @@

    Usage and SDK Samples

    otaFile:otaFile async:async expireInMins:expireInMins - completionHandler: ^(NSError* error) { + completionHandler: ^(ArduinoDevicev2Otaupload output, NSError* error) { + if (output) { + NSLog(@"%@", output); + } if (error) { NSLog(@"Error: %@", error); } @@ -20893,8 +21244,8 @@

    Usage and SDK Samples

    'async': true, // {Boolean} If false, wait for the full OTA process, until it gets a result from the device 'expireInMins': 56 // {Integer} Binary expire time in minutes, default 10 mins }; -api.devicesV2OtaUpload(id, otaFile, opts).then(function() { - console.log('API called successfully.'); +api.devicesV2OtaUpload(id, otaFile, opts).then(function(data) { + console.log('API called successfully. Returned data: ' + data); }, function(error) { console.error(error); }); @@ -20930,7 +21281,8 @@

    Usage and SDK Samples

    try { // upload devices_v2_ota - apiInstance.devicesV2OtaUpload(id, otaFile, async, expireInMins); + ArduinoDevicev2Otaupload result = apiInstance.devicesV2OtaUpload(id, otaFile, async, expireInMins); + Debug.WriteLine(result); } catch (Exception e) { Debug.Print("Exception when calling DevicesV2OtaApi.devicesV2OtaUpload: " + e.Message ); } @@ -20955,7 +21307,8 @@

    Usage and SDK Samples

    $expireInMins = 56; // Integer | Binary expire time in minutes, default 10 mins try { - $api_instance->devicesV2OtaUpload($id, $otaFile, $async, $expireInMins); + $result = $api_instance->devicesV2OtaUpload($id, $otaFile, $async, $expireInMins); + print_r($result); } catch (Exception $e) { echo 'Exception when calling DevicesV2OtaApi->devicesV2OtaUpload: ', $e->getMessage(), PHP_EOL; } @@ -20978,7 +21331,8 @@

    Usage and SDK Samples

    my $expireInMins = 56; # Integer | Binary expire time in minutes, default 10 mins eval { - $api_instance->devicesV2OtaUpload(id => $id, otaFile => $otaFile, async => $async, expireInMins => $expireInMins); + my $result = $api_instance->devicesV2OtaUpload(id => $id, otaFile => $otaFile, async => $async, expireInMins => $expireInMins); + print Dumper($result); }; if ($@) { warn "Exception when calling DevicesV2OtaApi->devicesV2OtaUpload: $@\n"; @@ -21004,7 +21358,8 @@

    Usage and SDK Samples

    try: # upload devices_v2_ota - api_instance.devices_v2_ota_upload(id, otaFile, async=async, expireInMins=expireInMins) + api_response = api_instance.devices_v2_ota_upload(id, otaFile, async=async, expireInMins=expireInMins) + pprint(api_response) except ApiException as e: print("Exception when calling DevicesV2OtaApi->devicesV2OtaUpload: %s\n" % e)
    @@ -21158,52 +21513,8 @@

    - - -
    -
    -

    -

    - - - - - - -
    -
    -

    -

    - - - - -
    -
    -
    +
    +
    +
    - +
    -

    -

    - - - - - - -
    -
    -

    -

    +

    +

    -