@@ -51,6 +51,36 @@ components:
5151 - signature_asn1_y
5252 title : ' Mediatype identifier: application/vnd.arduino.compressedv2; view=default'
5353 type : object
54+ ArduinoCredentialsv1 :
55+ description : ArduinoCredentialsv1 media type (default view)
56+ properties :
57+ friendly_name :
58+ description : Friendly name
59+ type : string
60+ required :
61+ description : Tell if the parameter is required or not
62+ type : boolean
63+ secret_name :
64+ description : The secret parameter name
65+ type : string
66+ sensitive :
67+ description : Tell if the field is sensitive
68+ type : boolean
69+ required :
70+ - secret_name
71+ - required
72+ - friendly_name
73+ - sensitive
74+ title : ' Mediatype identifier: application/vnd.arduino.credentialsv1+json; view=default'
75+ type : object
76+ ArduinoCredentialsv1Collection :
77+ description : ArduinoCredentialsv1Collection is the media type for an array of
78+ ArduinoCredentialsv1 (default view)
79+ items :
80+ $ref : ' #/components/schemas/ArduinoCredentialsv1'
81+ title : ' Mediatype identifier: application/vnd.arduino.credentialsv1+json; type=collection;
82+ view=default'
83+ type : array
5484 ArduinoDashboardowner :
5585 description : ArduinoDashboardowner media type (default view)
5686 properties :
@@ -1105,6 +1135,25 @@ components:
11051135 - tags
11061136 title : ' Mediatype identifier: application/vnd.arduino.tags+json; view=default'
11071137 type : object
1138+ ArduinoTemplate :
1139+ description : ArduinoTemplate media type (default view)
1140+ properties :
1141+ dashboards :
1142+ items :
1143+ format : uuid
1144+ type : string
1145+ type : array
1146+ things :
1147+ $ref : ' #/components/schemas/ArduinoThingresultCollection'
1148+ triggers :
1149+ items :
1150+ format : uuid
1151+ type : string
1152+ type : array
1153+ required :
1154+ - things
1155+ title : ' Mediatype identifier: application/vnd.arduino.template+json; view=default'
1156+ type : object
11081157 ArduinoTemplateproperty :
11091158 description : ArduinoTemplateproperty media type (default view)
11101159 properties :
@@ -1277,6 +1326,34 @@ components:
12771326 title : ' Mediatype identifier: application/vnd.arduino.thing+json; type=collection;
12781327 view=default'
12791328 type : array
1329+ ArduinoThingresult :
1330+ description : ArduinoThingresult media type (default view)
1331+ properties :
1332+ device_id :
1333+ description : UUID of the attached device
1334+ format : uuid
1335+ type : string
1336+ id :
1337+ description : UUID of the created Thing
1338+ format : uuid
1339+ type : string
1340+ sketch_id :
1341+ description : UUID of the created Sketch
1342+ format : uuid
1343+ type : string
1344+ required :
1345+ - id
1346+ - sketch_id
1347+ title : ' Mediatype identifier: application/vnd.arduino.thingresult+json; view=default'
1348+ type : object
1349+ ArduinoThingresultCollection :
1350+ description : ArduinoThingresultCollection is the media type for an array of
1351+ ArduinoThingresult (default view)
1352+ items :
1353+ $ref : ' #/components/schemas/ArduinoThingresult'
1354+ title : ' Mediatype identifier: application/vnd.arduino.thingresult+json; type=collection;
1355+ view=default'
1356+ type : array
12801357 ArduinoThingtemplate :
12811358 description : ArduinoThingtemplate media type (default view)
12821359 properties :
@@ -2411,6 +2488,29 @@ components:
24112488 - value
24122489 title : tag
24132490 type : object
2491+ template :
2492+ description : TemplatePayload describes the needed attribute to apply a template
2493+ properties :
2494+ custom_template_id :
2495+ description : The name of the directory on S3 bucket containing the user's
2496+ template
2497+ type : string
2498+ prefix_name :
2499+ description : The prefix to apply to the names of the generated resources
2500+ maxLength : 45
2501+ pattern : ^[a-zA-Z0-9_. -]+$
2502+ type : string
2503+ template_name :
2504+ description : The name of the directory on S3 bucket containing the template
2505+ example : remote-controlled-lights
2506+ type : string
2507+ things_options :
2508+ additionalProperties : true
2509+ type : object
2510+ required :
2511+ - template_name
2512+ title : template
2513+ type : object
24142514 thingSketch :
24152515 description : ThingSketchPayload describes a sketch of a thing
24162516 properties :
@@ -2626,6 +2726,173 @@ paths:
26262726 summary : list lora_freq_plan_v1
26272727 tags :
26282728 - lora_freq_plan_v1
2729+ /v1/network_credentials/{type} :
2730+ get :
2731+ description : Show required network credentials depending on device type
2732+ operationId : network_credentials_v1#show
2733+ parameters :
2734+ - description : Connection used by the device
2735+ in : query
2736+ name : connection
2737+ schema :
2738+ enum :
2739+ - wifi
2740+ - eth
2741+ - wifiandsecret
2742+ - gsm
2743+ - nb
2744+ - lora
2745+ - catm1
2746+ - cellular
2747+ type : string
2748+ - description : Device type
2749+ in : path
2750+ name : type
2751+ required : true
2752+ schema :
2753+ enum :
2754+ - mkrwifi1010
2755+ - mkr1000
2756+ - nano_33_iot
2757+ - mkrgsm1400
2758+ - mkrwan1310
2759+ - mkrwan1300
2760+ - mkrnb1500
2761+ - lora-device
2762+ - login_and_secretkey_wifi
2763+ - envie_m7
2764+ - nanorp2040connect
2765+ - nicla_vision
2766+ - opta
2767+ - giga
2768+ - portenta_c33
2769+ - unor4wifi
2770+ - nano_nora
2771+ type : string
2772+ responses :
2773+ " 200 " :
2774+ content :
2775+ application/vnd.arduino.credentialsv1+json; type=collection :
2776+ schema :
2777+ $ref : ' #/components/schemas/ArduinoCredentialsv1Collection'
2778+ description : OK
2779+ " 401 " :
2780+ description : Unauthorized
2781+ " 404 " :
2782+ description : Not Found
2783+ summary : show network_credentials_v1
2784+ tags :
2785+ - network_credentials_v1
2786+ /v1/network_credentials/{type}/connections :
2787+ get :
2788+ description : Show available connection types depending on device type
2789+ operationId : network_credentials_v1#showByDevice
2790+ parameters :
2791+ - description : Device type
2792+ in : path
2793+ name : type
2794+ required : true
2795+ schema :
2796+ enum :
2797+ - mkrwifi1010
2798+ - mkr1000
2799+ - nano_33_iot
2800+ - mkrgsm1400
2801+ - mkrwan1310
2802+ - mkrwan1300
2803+ - mkrnb1500
2804+ - lora-device
2805+ - login_and_secretkey_wifi
2806+ - envie_m7
2807+ - nanorp2040connect
2808+ - nicla_vision
2809+ - opta
2810+ - giga
2811+ - portenta_c33
2812+ - unor4wifi
2813+ - nano_nora
2814+ type : string
2815+ responses :
2816+ " 200 " :
2817+ description : OK
2818+ " 401 " :
2819+ description : Unauthorized
2820+ " 404 " :
2821+ description : Not Found
2822+ summary : showByDevice network_credentials_v1
2823+ tags :
2824+ - network_credentials_v1
2825+ /v1/templates :
2826+ put :
2827+ description : Apply an existing cloud template and generate all the needed resources
2828+ operationId : templates#apply
2829+ parameters :
2830+ - in : header
2831+ name : X-Organization
2832+ schema :
2833+ type : string
2834+ requestBody :
2835+ content :
2836+ application/json :
2837+ schema :
2838+ $ref : ' #/components/schemas/template'
2839+ application/x-www-form-urlencoded :
2840+ schema :
2841+ $ref : ' #/components/schemas/template'
2842+ description : TemplatePayload describes the needed attribute to apply a template
2843+ required : true
2844+ x-originalParamName : payload
2845+ responses :
2846+ " 200 " :
2847+ content :
2848+ application/vnd.arduino.template+json :
2849+ schema :
2850+ $ref : ' #/components/schemas/ArduinoTemplate'
2851+ application/vnd.goa.error+json :
2852+ schema :
2853+ $ref : ' #/components/schemas/ArduinoTemplate'
2854+ description : OK
2855+ " 400 " :
2856+ content :
2857+ application/vnd.arduino.template+json :
2858+ schema :
2859+ $ref : ' #/components/schemas/error'
2860+ application/vnd.goa.error+json :
2861+ schema :
2862+ $ref : ' #/components/schemas/error'
2863+ description : Bad Request
2864+ " 401 " :
2865+ description : Unauthorized
2866+ " 404 " :
2867+ content :
2868+ application/vnd.arduino.template+json :
2869+ schema :
2870+ $ref : ' #/components/schemas/error'
2871+ application/vnd.goa.error+json :
2872+ schema :
2873+ $ref : ' #/components/schemas/error'
2874+ description : Not Found
2875+ " 409 " :
2876+ content :
2877+ application/vnd.arduino.template+json :
2878+ schema :
2879+ $ref : ' #/components/schemas/error'
2880+ application/vnd.goa.error+json :
2881+ schema :
2882+ $ref : ' #/components/schemas/error'
2883+ description : Conflict
2884+ " 500 " :
2885+ content :
2886+ application/vnd.arduino.template+json :
2887+ schema :
2888+ $ref : ' #/components/schemas/error'
2889+ application/vnd.goa.error+json :
2890+ schema :
2891+ $ref : ' #/components/schemas/error'
2892+ description : Internal Server Error
2893+ summary : apply templates
2894+ tags :
2895+ - templates
26292896 /v2/dashboards :
26302897 get :
26312898 description : Returns the list of dashboards
0 commit comments