Hoppa till huvudinnehåll

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:

IdentifierNameDescription
idFiware entity id
secretSträng mellan 8 och 128 tecken, endast inkludera A-Z, 0-9, -, . and _
devEui64-bit globally-unique Extended Unique Identifier (EUI-64)
gatewayEui64-bit globally-unique Extended Unique Identifier (EUI-64)
imeiInternational Mobile Equipment Identity, 15 siffrigt number
tagvilken sträng som helst
serialNumbervilken 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://public.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