Generic integration

Generisk integration

Noder som för närvarande inte stöds av Yggio kan göras tillgängliga genom den generiska integrationen.

Generiska enheter identifieras med ett globalt unikt id. Det finns ett antal egenskaper som kan väljas som hållare av ditt id.
För närvarande stödda identifierare:

IdentifierName	Description
id	Fiware entity id
secret	Sträng mellan 8 och 128 tecken, endast inkludera A-Z, 0-9, -, . and _
devEui	64-bit globally-unique Extended Unique Identifier (EUI-64)
gatewayEui	64-bit globally-unique Extended Unique Identifier (EUI-64)
imei	International Mobile Equipment Identity, 15 siffrigt number
tag	vilken sträng som helst
serialNumber	vilken sträng som helst

Det finns två åtgärder som måste utföras, i vilken ordning som helst:

1. Skapa noden genom kontrollpanelen (eller API, det följer Lägga till enheter i Yggio)
   1.1 Logga in på Yggio med ditt användarnamn och lösenord 1.2 Navigera till IoT-noder på vänster sida 1.3 Tryck på knappen Ny IoT-node i det övre vänstra hörnet 1.4 Välj Generisk 1.5 Ange den unika id som ska användas för denna enhet och tryck på Nästa 1.6 Ge noden ett namn och tryck på Nästa 1.7 Om allt ser OK ut, tryck på Skapa och sedan Slutför

2. Skicka data till integrationen, antingen genom att använda HTTP eller MQTT. För MQTT, se MQTT Broker.
   För HTTP, ett meddelande ska skickas till <server>/http-push/generic medf följande format:

{
  <identifierName>: <identifier>,
  "basically": "any",
  "json": "compatible",
  "information": [1]
  "stuff": {
    "nested": "is allowed"
  }
}

Förfrågan måste också inkludera antingen en rubrik eller en frågesträng som bestämmer din identifierare: identifier=<identifierName> Ett exempel:

curl -sS https://staging.yggio.net/http-push/generic?identifier=secret \
-H 'content-type: application/json' \
-d @- <<EOF
{
  "secret": "ABCDEFGHIJKL_1234567890",
  "basically": "any",
  "json": "compatible",
  "information": [1],
  "stuff": {
    "nested": "is allowed"
  }
}
EOF