API-grondbeginselen

De Fit-it-on Developer API biedt programmatische toegang tot onze AI-generatiemodellen. Het volgt standaard REST-architectuurstijlen, gebruikt voorspelbare resource-georiënteerde URL's en accepteert JSON-gecodeerde request bodies.

Asynchrone uitvoering

Alle beeldgeneraties worden asynchroon verwerkt. AI-renders met hoge resolutie (2k of 2048x2048 samples) kosten tijd, en een synchrone verbinding zou onvermijdelijk een time-out geven.

1. Dien een taak in: U stuurt een POST /v1/run verzoek met uw invoergegevens.
2. Ontvang ID: De API retourneert onmiddellijk een 200 OK met een prediction_id.
3. Poll voor status: U roept periodiek GET /v1/status/{predictionId} aan.
4. Voltooiing: Wanneer de status overgaat naar succeeded, zijn de URL's naar uw gegenereerde afbeeldingen beschikbaar in de output-array.

Basis-URL

Alle verzoeken moeten via HTTPS naar onze productieomgeving worden gedaan:

https://fititon.app/api

Contenttypen

Alle POST- en PATCH-verzoeken moeten de volgende header bevatten om het payloadformaat te specificeren:

Content-Type: application/json

De API retourneert ook alle antwoorden strikt in JSON-formaat.

Webhooks

Als u een webhook_url opgeeft in de root van uw JSON-payload, sturen we een HTTP POST-verzoek naar die URL zodra de asynchrone taak is voltooid (succesvol of met een fout).

Voorbeeld van Webhook-payload:

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "output": [
    "https://storage.fititon.com/results/result-123.jpg",
    "https://storage.fititon.com/results/result-124.jpg"
  ],
  "error": null,
  "created_at": "2026-07-03T10:00:00.000Z",
  "updated_at": "2026-07-03T10:00:15.000Z"
}

Verzoeklimieten & Afhandeling

Om misbruik te voorkomen, handhaaft de API een snelheidslimiet op basis van uw actieve Developer Plan-tier.

Als u uw limiet overschrijdt, ontvangt u een 429 Too Many Requests-fout. Uw applicatie moet dit gracieus afhandelen door exponentiële backoff te implementeren.