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
  }
}

Fil-inputs

Inputs af typen file sendes som et JSON-objekt med tre felter:

{
  "inputs": {
    "document": {
      "filename": "rapport.pdf",
      "mime_type": "application/pdf",
      "data": "<base64-kodet indhold>"
    }
  }
}

Felt	Beskrivelse
filename	Det originale filnavn (f.eks. "rapport.pdf")
mime_type	Filens MIME-type (f.eks. "application/pdf")
data	Filens indhold, base64-kodet (uden data: prefix)

Response

{
  "results": {
    "output_felt": "resultat"
  }
}

Fil-outputs returneres i samme format:

{
  "outputs": {
    "dokument": {
      "filename": "resultat.pdf",
      "mime_type": "application/pdf",
      "data": "<base64-kodet indhold>"
    }
  }
}

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["results"])

Eksempel med fil-upload (Python)

import base64
import requests

# Indlæs fil og konvertér til base64
with open("dokument.pdf", "rb") as f:
    file_data = base64.b64encode(f.read()).decode("utf-8")

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": {
            "document": {
                "filename": "dokument.pdf",
                "mime_type": "application/pdf",
                "data": file_data
            }
        }
    }
)

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

Relaterede sider

• API-nøgler
• Kør app