> ## Content Index
> Fetch the complete content index at: https://blog.esadax.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Esadax REST API Endpoints Yleiskatsaus
- URL: https://blog.esadax.com/fi/esadax-rest-api-endpoints-yleiskatsaus/
- Published: 2026-11-15T04:21:44.000Z
- Updated: 2026-11-15T04:21:44.000Z
- Author: Esadax 
- Tags: #tr-platform-20-infrastructure-52-rest-api-endpoints, #fi, #mdx-imported, Platform

Esadax REST API tarjoaa kattavan joukon päätepisteitä erilaisten resurssien, kuten salaisuuksien, palomuurien, tiimien, käyttäjien ja webhookien, hallintaan. Alla on järjestetty yhteenveto siitä, miten näitä päätepisteitä käytetään tehokkaasti:

### Todentaminen

- **Menetelmä**: Varmista, että käytössäsi on tarvittava todennusmenetelmä, joka voi olla tunnus tai API-avain. Tarkista Esadaxin dokumentaatiosta tarkemmat tiedot.

### Resurssinhallinta

#### Salaisuudet

- **Hae Secrets**: Käytä `GET /v2/secrets` kanssa sivuutus tarvittaessa.
- **Päivitä salainen nimi**: Käytä `PATCH /v2/secrets/{name}`\-koodia muuttaaksesi nimen ja varmistaaksesi, että se on yksilöllinen käyttäjälle tai joukkueelle.

#### Palomuurin kokoonpano

- **Hanki nykyinen kokoonpano**: Käytä `GET /v1/firewalls/{configVersion}`.
- **Päivitä kokoonpano**: Käytä `PUT /v1/firewalls` uusilla säännöillä.

#### Hyökkäys haastetila

- **Ota käyttöön/poista käytöstä**: Käytä `POST /v1/attack-challenge-mode` vaihtaaksesi asetusta.

#### Ryhmät

- **Luo joukkue**: Lähetä POST-pyyntö osoitteeseen `/v1/teams`, jossa on slug ja valinnainen nimi.
- **Poista joukkue**: Käytä DELETE `/v1/teams/{teamId}`: ssa valinnaisilla syillä.
- **Poista kutsukoodi**: Käytä DELETE-toimintoa `/v1/teams/{teamId}/invites/{inviteCode}`:ssa.
- **Get Team Info**: Käytä GET `/v2/teams/{teamId}`.
- **Listaa jäsenet**: Käytä GET-toimintoa `/v2/teams/{teamId}/members`:ssa, sivuuttaen tarpeen mukaan.
- **Kutsu käyttäjiä**: Lähetä viesti osoitteeseen `/v1/teams/{teamId}/members` sähköpostilla tai ID:llä (ID on etusijalla).
- **Liity tiimiin**: Lähetä viesti osoitteeseen `/v1/teams/join` kutsukoodilla tai tiimin ID:llä.
- **Päivitä joukkueen tiedot**: PATCH `/v2/teams/{teamId}`: ssa uusilla yksityiskohdilla.
- **Poista jäsen**: DELETE on `/v1/teams/{teamId}/members/{uid}`.
- **Pyydä käyttöoikeutta**: Lähetä viesti osoitteeseen `/v1/teams/{teamId}/request`.
- **Vahvista pyyntö**: PATCH on `/v1/teams/{teamId}/members/{uid}` jos vahvistettu.

#### Käyttäjät

- **Hanki käyttäjän tiedot**: Käytä GET `/v2/user`.
- **Luettelo Tapahtumat**: Käytä GET `/v3/events`.

#### Webhooks

- **Luo Webhook**: POST osoitteeseen `/v1/webhooks`.
- **Poista Webhook**: DELETE on `/v1/webhooks/{webhookId}`.
- **Hanki Webhook Info**: GET on `/v1/webhooks/{webhookId}`.
- **Luettelo Webhooks**: Käytä GET `/v1/webhooks`.

### Parhaat käytännöt

- **Käyttöoikeudet**: Varmista, että sinulla on tarvittavat käyttöoikeudet, kuten ylläpitäjän oikeudet tai omistajuus tiimin hallintaa varten.
- **Virheiden käsittely**: Toteuta virheiden käsittely erilaisten HTTP-tilakoodien ja virheiden hallitsemiseksi asianmukaisesti.

### Esimerkki työnkulusta

1. **Luo joukkue**:
  - Lähetä POST osoitteeseen `/v1/teams` koodilla `{"slug": "example-team", "name": "Example Team"}`.
2. **Kutsu käyttäjiä**:
  - Käytä POSTia osoitteessa `/v1/teams/{teamId}/members` käyttäjätiedoilla tai kutsukoodeilla.
3. **Liity tiimiin**:
  - Lähetä viesti POST numeroon `/v1/teams/join` joukkueen ID:llä tai kutsukoodilla.
4. **Päivitä palomuurin säännöt**:
  - PUT kohteeseen `/v1/firewalls` uudella kokoonpanolla.