API-brug

Lær at bruge API-nøgler til at køre apps programmatisk.

Adgang

• Udvikler, Anmelder, Administrator: Kan oprette og bruge API-nøgler

Forudsætninger

• En aktiv API-nøgle (se API-nøgler)
• En publiceret app du har adgang til

Kør app via API

Endpoint

POST /api/v1/apps/{app_id}/run

Headers

Authorization: Bearer sk_din_api_nøgle
Content-Type: application/json

Request body

{
  "inputs": {
    "input_felt_1": "værdi",
    "input_felt_2": 123
  }
}

Response

{
  "execution_id": "uuid",
  "status": "completed",
  "outputs": {
    "output_felt": "resultat"
  }
}

Streaming-kørsel

For at modtage real-time opdateringer under kørsel:

Endpoint

POST /api/v1/apps/{app_id}/run-stream

Headers

Authorization: Bearer sk_din_api_nøgle
Accept: text/event-stream
Content-Type: application/json

SSE Events

Du modtager følgende event-typer:

Event	Beskrivelse
node_start	En byggeklods starter
node_complete	En byggeklods er færdig
node_error	En byggeklods fejlede
agent_complete	Hele agenten er færdig
agent_error	Agenten fejlede

Begrænsninger

API-nøgler kan kun bruges til at køre apps. De kan ikke:

• Liste agenter
• Oprette agenter
• Liste apps
• Oprette apps
• Ændre brugerdata

Fejlhåndtering

HTTP Status	Betydning
401	Ugyldig eller tilbagekaldt API-nøgle
403	Ingen adgang til appen
404	App ikke fundet
422	Ugyldig input
500	Serverfejl

Eksempel med cURL

curl -X POST "https://din-server.dk/api/v1/apps/{app_id}/run" \
  -H "Authorization: Bearer sk_din_api_nøgle" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"tekst": "Hej verden"}}'

Eksempel med Python

import requests

response = requests.post(
    "https://din-server.dk/api/v1/apps/{app_id}/run",
    headers={
        "Authorization": "Bearer sk_din_api_nøgle",
        "Content-Type": "application/json"
    },
    json={"inputs": {"tekst": "Hej verden"}}
)

result = response.json()
print(result["outputs"])

Relaterede sider

• API-nøgler
• Kør app