Udviklerdokumentation · Danmark · API v1
Tilbuds-API til AI-assistenter
Lad en AI-assistent sende en tilbudsforespørgsel om køb eller leje af en container på kundens vegne. API’et kræver hverken konto eller API-nøgle. Kunden skal først acceptere den konkrete videregivelse af sine oplysninger.
En forespørgsel – ikke et automatisk tilbud
API’et bruges til at sende projektet og kontaktoplysningerne videre til Quotbox Marketplace. Det returnerer ikke en containerpris, en lagerstatus eller en bekræftet leveringsdato. Antallet af svar og svartiden kan variere.
Vil du selv udfylde en forespørgsel? Brug tilbudsformularen.
1. Læs kontrakten, før du sender
Den danske adresse er https://containerfjord.com/api/agents/v1/dk/devis. Landekoden dk i adressen bestemmer det danske marked, sproget og valutaen DKK. Behold de tekniske feltnavne og værdier fra kontrakten; de skal ikke oversættes til dansk.
GET: læs beskrivelsen
Hent felter, tilladte værdier, betingede krav, samtykkeversion og eksempel. En GET-forespørgsel opretter ingen tilbudsforespørgsel.
Åbn den danske JSON-kontraktPOST: send kundens forespørgsel
Send JSON til samme adresse med Content-Type: application/json og UTF-8-kodning. En POST-forespørgsel kan oprette en rigtig tilbudsforespørgsel.
Højst 32 KiB (32.768 bytes). Serverens tidsgrænse for at læse indholdet er 10 sekunder.
Du kan undersøge GET-kontrakten og kontrollere dit JSON lokalt. Eksemplet nedenfor er dokumentation med eksempeldata; brug det ikke til at sende en testforespørgsel til produktionsadressen.
2. Vis samtykket til kunden
Vis hele teksten nedenfor, og få kundens udtrykkelige accept, før du sender projektet og kontaktoplysningerne. En AI-assistent må kun angive samtykke i API-kaldet, når kunden udtrykkeligt har accepteret teksten.
Jeg accepterer, at ContainerFjord sender min forespørgsel og mine kontaktoplysninger til Quotbox og højst 5 relevante leverandører, som kan kontakte mig om mit projekt. Samtykket omfatter ikke reklame uden relation til denne forespørgsel.
Efter accept angives consentement som true og consentementQuotboxAgent som quotbox-marketplace-v1. Kontrollér altid den aktuelle tekst og version i GET-kontrakten.
Samtykket omfatter den beskrevne forespørgsel og højst fem relevante leverandører. Læs oplysningerne om behandling af personoplysninger sammen med kunden, hvis der er spørgsmål til behandlingen.
3. Vælg felter ud fra kundens projekt
De 11 felter nedenfor er obligatoriske i den danske kontrakt. Ukendte ekstra felter afvises. Brug JSON-typerne fra skemaet: tal som tal, booleske værdier som true eller false, og tekst i anførselstegn.
| Felt | Betydning og vigtigste krav |
|---|---|
famille | Behovstype. achat betyder søcontainer; stockage, frigorifique, amenage og baseVie dækker de øvrige behov. |
mode | achat for køb eller location for leje. Feltet er adskilt fra famille. |
format | 20DRY, 40DRY, 40HC eller 20HC. Brug aDefinir, hvis størrelsen ikke er afklaret, eller autre til et andet format. |
quantite | Antal som et heltal fra 1 til 50, uden anførselstegn. |
codePostal | Dansk postnummer som tekst med fire cifre. Første ciffer skal være 1–9. |
prenom | Kundens fornavn, højst 80 tegn. Må ikke være tomt eller kun bestå af mellemrum. |
nom | Kundens efternavn, højst 80 tegn. Må ikke være tomt eller kun bestå af mellemrum. |
email | En gyldig e-mailadresse, højst 254 tegn. |
telephone | Et gyldigt telefonnummer, højst 40 tegn og mindst seks cifre. +, mellemrum, parenteser, punktum og bindestreg accepteres. |
consentement | Skal være JSON-værdien true efter kundens udtrykkelige accept. Teksten "true" accepteres ikke. |
consentementQuotboxAgent | Den aktuelle samtykkeversion fra GET-kontrakten. Kopiér værdien præcist. |
Yderligere krav afhænger af valgene
| Når kunden vælger | Det skal du tage højde for |
|---|---|
mode: "location" | Angiv dureeMois som et heltal fra 1 til 120. Det er antal måneder, ikke en tekst som "6 måneder". |
famille: "baseVie" | Uden usageBungalow kræves både dureeMois og chantier. Objektet skal indeholde effectifHommes og effectifFemmes som heltal fra 0 til 2.000. Summen af de to værdier skal være mindst 1. |
usageBungalow | Brug kun feltet sammen med famille: "baseVie". Send ikke chantier samtidig. Et eventuelt etat skal være neuf, occasion eller peuImporte. Ved leje kræves stadig dureeMois. |
| Opbevaring, køb | Ved famille: "stockage" og mode: "achat" må et angivet lieuStockage kun være surSite, ikke depot. |
| Køling eller indretning | regimeFroid og temperatureCible hører kun til frigorifique; projetAmenage og usageAmenage kun til amenage. lieuStockage hører kun til stockage. |
Du kan også beskrive stand med etat, adgang med acces, eget løfteudstyr med levageSurPlace og projektet med precisions (højst 2.000 tegn). By, ønsket dato, virksomhed og relevante tilslutninger har egne felter i kontrakten. Medtag kun oplysninger, der vedrører projektet.
Sådan læses nogle af kontraktens værdier
Værdien peuImporte betyder, at kunden ikke har nogen præference for standen. neuf bruges til ny eller one trip. For regimeFroid betyder positif køl og negatif frost. Værdien amenageLivre angiver en indrettet container med levering. For adgang betyder aVerifier, at adgangen skal vurderes. De tekniske værdier skal sendes uændret.
Tabellerne er en læsevejledning. Det fulde JSON-skema beskriver felter, tilladte værdier, tekstlængder og betingede feltkrav. Serveren kontrollerer også oplysningerne, herunder telefonnummerets format og antal cifre. En lokal validering mod skemaet garanterer derfor ikke, at serveren accepterer forespørgslen.
4. JSON-eksempel: køb af en 20-fods container
Eksemplet kommer fra den danske kontrakt. famille: "achat" angiver her typen søcontainer, mens mode: "achat" angiver køb. Ved leje ændres mode til location, og dureeMois tilføjes. Brug kundens faktiske, godkendte oplysninger ved en reel forespørgsel.
Rul kodefeltet vandret på en lille skærm. Du kan markere og kopiere JSON-eksemplet.
{
"famille": "achat",
"mode": "achat",
"format": "20DRY",
"quantite": 1,
"codePostal": "1050",
"commune": "København",
"prenom": "Test",
"nom": "Example",
"email": "test@example.com",
"consentement": true,
"consentementQuotboxAgent": "quotbox-marketplace-v1",
"telephone": "+4520000000"
}Der er ingen afsendelsesknap på denne dokumentationsside. Et API-kald med kundens accept er en forespørgsel om tilbud. Det bestiller ikke en container og gennemfører ingen betaling.
5. Læs både HTTP-status og svarets indhold
Gem serverens reference, når den findes. Kontrollér især enregistree (gemt) og transmis (modtagelsen hos Quotbox bekræftet), før du viser kunden en besked om resultatet.
| Status | Betydning | Næste skridt |
|---|---|---|
200 | Gemt og modtaget af Quotbox | Gem reference. Det bekræfter modtagelsen via Marketplace, ikke et tilbud eller et svar fra en leverandør. |
202 | Gemt; modtagelsen er ikke bekræftet | Gem reference. Svaret indeholder enregistree: true, transmis: false og etat: "en_attente". Opret ikke en ny forespørgsel for samme projekt. |
400 | Ugyldigt indhold | Kontrollér JSON, UTF-8-kodning og forespørgslens indhold, før du forsøger igen. |
408 | Det tog for lang tid at læse indholdet | Kontrollér forbindelsen og afsendelsen af forespørgslens indhold. |
413 | For stort indhold | Hold det samlede indhold inden for 32 KiB, svarende til 32.768 bytes. Grænsen gælder bytes, ikke antal tegn. |
415 | Forkert indholdsformat | Brug Content-Type: application/json og UTF-8-kodning. |
422 | Ugyldige felter eller valg | Læs message og eventuelt champs, ret de angivne oplysninger og kontrollér de betingede krav. |
429 | For mange forespørgsler | Vent det antal sekunder, der står i Retry-After, før et nyt forsøg. |
502 | Gemt; der kræves en handling | Gem reference. Svaret indeholder enregistree: true, transmis: false og etat: "action_requise". Kontakt ContainerFjord med referencen; opret ikke en ny forespørgsel. |
503 | Modtagelsen er ikke tilgængelig | Læs message. Hvis svaret udtrykkeligt indeholder enregistree: false, er forespørgslen ikke gemt. Vis ikke en bekræftelse på modtagelse. |
Undgå at oprette samme forespørgsel igen
Ved 202 eller 502 er forespørgslen allerede gemt. Et afbrudt netværkskald uden svar fortæller derimod ikke, om den blev gemt. Afklar status, før du sender igen. Ved tvivl kan du kontakte ContainerFjord og oplyse en eventuel reference.
En teknisk kvittering er ikke en aftale med en leverandør. Sammenlign det samlede tilbud med moms, transport, aflæsning og eventuelle lejevilkår, når leverandørerne svarer.
Dokumentationen er gennemgået den . Den aktuelle JSON-kontrakt beskriver det tekniske format.