Första löpningen
- Steg 1
Öppna utvecklarintegrationer och granska de för närvarande tillgängliga omfattningarna.
- Steg 2
Skapa en token endast för de operationer du behöver.
- Steg 3
Använd exemplen och dataformatet som visas i instrumentpanelen. Håll markören när du läser händelser.
- Steg 4
Hantera avbrott, omförsök och inga nya händelser. Återkalla en token som du inte längre behöver.
Sändningsexempel
Ditt eget verktyg hämtar efterföljande händelser utan att bearbeta samma historik flera gånger. Markören låter dig fortsätta från den sista positionen, och tokens begränsade omfång begränsar dess behörigheter.
Handling och möjligheter
Nycklar med intervall
I integrationer skapar du en nyckel med separata behörigheter för LIVE-tillstånd, händelser, timer eller musikkö. Vi visar bara nyckeln en gång. Välj en giltighetstid på 7, 30 eller 90 dagar; du kan återkalla den när som helst.
Läs och markör
Skicka nyckeln i rubriken Authorization: Bearer. Läsning av händelser använder eftermarkören, tack vare vilken automatiseringen inte upprepar gamla meddelanden. Den första avläsningen utan markör börjar från det aktuella ögonblicket. Läsningen är begränsad till nyckelägarens data.
Exempel och dokumentation
Ladda ner OpenAPI 3.1-beskrivningen och JavaScript-exemplet till din egen server, Node-RED eller annan automationsmiljö. Skicka en förfrågan i taget, rekommenderad varannan sekund, med en gräns på 60 förfrågningar per minut. Placera inte nyckeln i offentlig HTML eller i överläggsadressen.
Se gränssnittet på nära håll
Klicka på illustrationen för att förstora den. Skärmbilderna visar olika delar av installationen; bildtexten förklarar vad du ska hålla utkik efter.
När något inte fungerar
Begäran nekas åtkomst
Kontrollera token och önskat omfattning. Använd uppdaterad slutpunktsdokumentation och rätt begäranmetod.
Samma händelser upprepar sig
Lagra den returnerade markören och deduplicerade ID:n. Börja inte varje läsning från början av berättelsen.