Hur skapar jag en API-token?

Skapa en API token role (roll för API-token) innan du skapar tokenen. Administratörsåtkomst räcker inte ensam: varje token får sina behörigheter från en särskild API-roll.

1. Innan du börjar#

• Logga in som administratör för företaget.
• Bestäm vilka varumärken, konton i sociala medier och funktioner integrationen behöver.
• Förbered en hemlighetshanterare eller en annan säker plats där du kan spara tokenen direkt. Nonli visar den fullständiga hemligheten bara en gång.

2. Skapa rollen för API-token#

1. Öppna huvudmenyn och välj sedan Roles under Workspace.
2. Välj Add role.
3. Ange ett tydligt namn, till exempel ”Daily statistics export”.
4. Under Role type väljer du API token role.
5. Ge bara de behörigheter för funktioner och varumärken som krävs. Använd läsbehörighet för en export som inte behöver publicera eller ändra data.
6. Granska behörigheterna och välj sedan Save.

Rollen styr vad tokenen kan se och ändra. Ge inte åtkomst på administratörsnivå för att komma runt en enskild behörighet som saknas. Du kan gå igenom den allmänna behörighetsmodellen i Hur konfigurerar jag en ny roll?.

3. Skapa token#

1. Öppna huvudmenyn, välj My Company och leta sedan upp API tokens.
2. Välj New token.
3. Ange ett Name (namn) som identifierar integrationen.
4. Välj den API token role som du skapade i föregående steg.
5. Välj det Expiration-datum (utgångsdatum) som din säkerhetspolicy kräver.
6. Välj Create token.
7. När Copy this token now visas, kopierar du hela tokenen direkt till din hemlighetshanterare. Du kommer inte att kunna hämta den från tabellen senare.

När tokenen har skapats, ersätter bekräftelsefönstret formuläret och visar hemligheten en gång, så förvara den på ett säkert sätt innan du stänger fönstret.

Placera aldrig tokenen i källkod, en URL, en skärmbild, ett meddelande till supporten eller applikationsloggar. Den som har värdet kan använda de behörigheter som har tilldelats dess roll.

4. Autentisera en API-förfrågan#

Skicka tokenen i HTTP-huvudet Authorization:

1Authorization: Bearer YOUR_API_TOKEN

API-token representerar en roll i företaget, inte en webbanvändare i Nonli. Testa autentiseringsuppgiften genom att anropa GET /brands?size=1&fields=id,name; använd inte /me. Fortsätt med referensen för utvecklar-API:et för slutpunkter, sidnumrering, fel och exempel på förfrågningar.

5. Om ”No API role available” visas#

Gå tillbaka till Roles och kontrollera att minst en sparad roll har Role type inställt på API token role. En användarroll kan inte kopplas till en token.

Om sidan också visar Unable to load API roles, please retry, ladda om sidan innan du ändrar någon roll. Ett fel vid inläsningen är inte detsamma som att företaget saknar API-roll.

6. Rotera eller återkalla en token#

Använd Rotate när en hemlighet kan ha exponerats, har gått förlorad eller måste förnyas. Rotationen ogiltigförklarar den tidigare hemligheten omedelbart, så uppdatera integrationen med den nya innan dess nästa förfrågan.

Använd Revoke för att stoppa en integration permanent. Återkallelsen träder också i kraft omedelbart. Det förkortade fingeravtrycket som visas i tokentabellen identifierar en token men kan inte användas som autentiseringsuppgift.