Spring til indhold

Tilføj rækker

Tilføj rækker til en kladde, så en liste over uploadgrænsen kan sendes i dele.

POST/v1/jobs/{id}/rows

Kun et job i status draft (oprettet med start: false) tager rækker. Body’en er { rows }, en fil eller en rå CSV/NDJSON-body — som ved oprettelsen, højst 10 MB pr. kald. Rækkerne nummereres i den rækkefølge, de kommer.

Start jobbet med Start et job, når den sidste del er sendt.

Vil jobbet komme over din plans rækker pr. job, svarer kaldet 402 og tæller ikke mod kvoten.

Godkendelse · API-nøgle eller session

Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.

Afregning

Som ved oprettelsen: kun rækker, der lykkes, faktureres.

Eksempel

curl -X POST "https://api.grundfast.dk/v1/jobs/job_4n8q2v7k1m9x3c5z0w6r2t8b/rows" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"kunde":"1003","adresse":"Torvet 1, 6100 Haderslev"}]}'
Svar · eksempel200
{
  "job": {
    "id": "job_4n8q2v7k1m9x3c5z0w6r2t8b",
    "kind": "datavask",
    "status": "draft",
    "label": "Kundeliste oktober",
    "totalRows": 3,
    "processedRows": 0,
    "succeeded": 0,
    "failed": 0,
    "billedUnits": 0,
    "progress": 0,
    "columns": { "adresse": "adresse" },
    "srid": 4326,
    "inputColumns": ["kunde", "adresse"],
    "error": null,
    "createdAt": "2026-10-05T09:12:03.418Z",
    "startedAt": null,
    "completedAt": null,
    "updatedAt": "2026-10-05T09:12:05.117Z",
    "resultsAvailable": true
  }
}

Parametre

idstringstipåkrævet
Jobbets id fra job.id.Eksempel: job_4n8q2v7k1m9x3c5z0w6r2t8b

Request-body

JSON med Content-Type: application/json.

rowsobject[]bodypåkrævet
Mindst én række i samme form som ved oprettelsen.

Felter i svaret

job.totalRowsinteger
Rækker i jobbet efter tilføjelsen.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Body’en kan ikke læses, eller den har ingen rækker.
401Hverken en gyldig nøgle eller en session.
403Nøglen er en admin-nøgle, eller kontoen er suspenderet.
404Der findes intet job med det id på din konto.
409Jobbet er ikke længere en kladde.
413Uploaden er over 10 MB.
429Burst-grænsen eller månedskvoten er nået.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

POST /v1/jobs/job_4n8q2v7k1m9x3c5z0w6r2t8b/rows

Bruges ofte sammen med