Grenser

Grensene holder API-et raskt for alle verksteder. De fleste teller per nøkkel. Noen teller for hele verkstedet, på tvers av nøklene.

Kall per nøkkel og verksted

Hva	Grense
Lesing per nøkkel	120 i minuttet
Skriving per nøkkel	30 i minuttet
Priser per nøkkel	60 i minuttet
Filer per nøkkel	10 i minuttet
Alle kall per nøkkel	5 000 i døgnet
Priser per nøkkel	2 000 i døgnet
Nye ordre per nøkkel	500 i døgnet
Nye ordre per kundenøkkel	100 i døgnet
Alle kall per verksted	20 000 i døgnet
Feil nøkkel fra samme adresse	20 på 10 minutter

En sandkasse har halvparten av hver grense. GET /me viser grensene som gjelder for nøkkelen.

Hvilken klasse et kall teller i

Hver operasjon hører til en klasse, og teller mot klassens grense per minutt. I tillegg teller hvert kall mot alle kall per nøkkel og per verksted i døgnet. Priser har også en grense per døgn, og POST /orders teller mot nye ordre per døgn.

Klasse	Operasjoner
`read` lesing, 120 i minuttet	GET/me GET/catalog/library GET/catalog/products GET/catalog/products/{id}GET/orders GET/orders/{number}GET/orders/{number}/attachments/{id}GET/orders/{number}/events GET/agreements GET/agreements/{number}GET/customers GET/customers/{id}GET/customers/{id}/projects GET/invoices GET/invoices/{id}GET/invoices/{id}/pdf GET/events GET/shop GET/orders/{number}/payments GET/orders/{number}/bending-sheets GET/bending-sheets/{id}GET/bending-sheets/{id}/pdf GET/bending-sheets/{id}/dxf GET/production/queue GET/presses GET/reports/months/{month}
`write` skriving, 30 i minuttet	POST/orders PATCH/orders/{number}POST/orders/{number}/confirm POST/orders/{number}/cancel POST/orders/{number}/status POST/customers PATCH/customers/{id}POST/orders/{number}/payment-link POST/bending-sheets/{id}/bent
`prices` priser, 60 i minuttet	POST/prices POST/delivery-quotes
`upload` filer, 10 i minuttet	POST/orders/{number}/attachments
`public` ingen nøkkel	GET/openapi.json

Overskriftene

Hvert svar har X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset. De gjelder grensen per minutt for klassen kallet teller i:

X-RateLimit-Limit: hvor mange kall klassen tillater i minuttet;
X-RateLimit-Remaining: hvor mange som er igjen;
X-RateLimit-Reset: når minuttet begynner på nytt, i sekunder siden 1970 (Unix-tid).

Svar på GET /orders


HTTP/1.1 200 OK
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 1797590580

Over grensen: 429

Over grensen svarer vi 429 rate_limited med Retry-After. Vent så mange sekunder før du prøver igjen. Det samme tallet står i retryAfterSeconds.

Over grensen


HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1797590580
X-Request-Id: req_8f2KQx7Lp0aZtR4mWc1V

{
  "error": {
    "code": "rate_limited",
    "message": "For mange kall. Vent `retryAfterSeconds` sekunder.",
    "retryAfterSeconds": 12,
    "requestId": "req_8f2KQx7Lp0aZtR4mWc1V"
  }
}

Prøv ikke igjen i en løkke uten pause. Vent det Retry-After sier, og spre kallene utover.

Andre grenser

Hva	Grense
Filer på en ordre	høyst 15 MB per fil og 10 filer per ordre
Filtyper	JPEG, PNG, WebP, HEIC eller PDF
Adressen til en fil du henter	virker i 5 minutter
Linjer per ordre	høyst 100
Antall på en linje	1–500
`externalRef`	høyst 100 tegn
Tekstfelt i en ordre	høyst 2 000 tegn
En ordre med bare en merknad	`note` på minst 3 tegn
`limit` i lister	1–100, 25 når du ikke sender den
`Idempotency-Key`	8–255 tegn, huskes i 24 timer
Nøkler i bruk per verksted	høyst 10
Webhook-adresser per verksted	høyst 10
En beskjed (webhook)	under 256 KB
Svar på en beskjed	en 2xx innen 10 sekunder
`GET /events`	30 dager tilbake
«Siste kall» for en nøkkel	lagres i 14 dager
Testordre	slettes etter 30 dager