Vuokraus
Kun mode on location, anna vuokra-aika kuukausina kentässä dureeMois. Käytä kokonaislukua väliltä 1–120.
Kehittäjille · Suomi · fi-FI · EUR
Tekoälyavustaja voi lähettää asiakkaan hyväksymän tarjouspyynnön kontista tai työmaatilasta Suomessa. Rajapinta on julkinen, ja sitä voi käyttää ilman tiliä tai API-avainta.
Asiakkaan suostumuksella pyyntö ja yhteystiedot välitetään Quotboxin kautta enintään viidelle rekisteröityneelle yritykselle. Tarjouksen laatii toimittaja. Rajapinta ei anna hintaa, tee tilausta tai takaa tarjouksen saamista.
GET palauttaa ajantasaisen JSON-kuvauksen: kentät, sallitut arvot, ehdot, suostumustekstin ja esimerkin. Linkin avaaminen ei lähetä tarjouspyyntöä.
https://containerfjord.com/ api/ agents/ v1/ fi/ devisLähetä UTF-8-koodattu JSON samaan osoitteeseen ja määritä sisältötyyppi HTTP-otsakkeessa.
Content-Type: application/jsonRajapinnan versionumero on 1. JSON-rungon enimmäiskoko on 32 KiB (32 768 tavua), ja rungon lukemisen aikaraja on 10 sekuntia. Osoitteen maatunnus fi valitsee Suomen rajapinnan (kieli- ja aluetunnus fi-FI, valuutta EUR). Kenttien nimet ja koodiarvot ovat yhteisiä eri maissa: älä käännä niitä.
Näytä asiakkaalle Suomen JSON-kuvauksen suostumusteksti kokonaan. Älä aseta hyväksyntää asiakkaan puolesta. Lähetä tiedot vasta, kun asiakas on nimenomaisesti hyväksynyt niiden välittämisen kuvattuun tarkoitukseen.
Hyväksyn, että ContainerFjord välittää tarjouspyyntöni ja yhteystietoni Quotboxin kautta enintään 5 rekisteröityneelle ammattilaisyritykselle, jotka voivat laatia tarjouksia hankkeestani Suomessa. Tämä pyyntö ei rekisteröi minua mainoskampanjoihin.
true, ei merkkijono "true".quotbox-marketplace-v1Käytä aina GET-kuvauksen nykyistä tekstiä ja versiota. Katso tietosuojaseloste ja rekisterinpitäjän yhteystiedot.
Lähetä yksi JSON-objekti, jossa ovat kaikki taulukon kentät. Vuokraukseen ja tiettyihin tuoteryhmiin tarvitaan myös lisätietoja. Tuntemattomat kentät hylätään.
| Kenttä | Arvo ja käyttötarkoitus |
|---|---|
| famille | Tuoteryhmän koodi. Merikontin koodi on achat. Katso muut tuoteryhmät JSON-kuvauksesta. |
| mode | achat = osto, location = vuokraus. |
| format | Kokokoodi, esimerkiksi 20DRY, 40DRY tai 40HC. Käytä arvoa aDefinir, jos kokoa ei ole vielä valittu. |
| quantite | Kappalemäärä kokonaislukuna 1–50. |
| codePostal | Suomen postinumero merkkijonona: viisi numeroa, esimerkiksi "00100". Arvo 00000 ei kelpaa. |
| prenom | Asiakkaan etunimi, 1–80 merkkiä. Pelkkä välilyönti ei kelpaa. |
| nom | Asiakkaan sukunimi, 1–80 merkkiä. Pelkkä välilyönti ei kelpaa. |
| Asiakkaan sähköpostiosoite, enintään 254 merkkiä. Osoitteen pitää sisältää myös kelvollinen verkkotunnus. | |
| consentement | Totuusarvo true vasta asiakkaan nimenomaisen hyväksynnän jälkeen. |
| consentementQuotboxAgent | Kopioi suostumuksen version tunniste GET-kuvauksesta sellaisenaan. |
| telephone | Asiakkaan puhelinnumerossa on oltava 6–15 numeroa ja yhteensä enintään 30 merkkiä. Välilyönnit, sulkeet, pisteet ja yhdysmerkit ovat sallittuja. Plusmerkkiä voi käyttää numeron alussa. Alun ja lopun välilyöntejä ei lasketa merkkirajaan. |
Anna quantite ja dureeMois JSON-lukuina. Anna postinumero merkkijonona, jotta alkunolla säilyy. Palvelu tarkistaa puhelinnumeron myös silloin, kun pyyntö täyttää JSON-skeeman ehdot.
Kun mode on location, anna vuokra-aika kuukausina kentässä dureeMois. Käytä kokonaislukua väliltä 1–120.
Kun famille on baseVie ja usageBungalow puuttuu, anna osto- ja vuokrauspyynnössä dureeMois kuukausina sekä chantier. Ilmoita chantier-objektissa miesten määrä (effectifHommes) ja naisten määrä (effectifFemmes). Kummankin arvon on oltava kokonaisluku väliltä 0–2 000, ja henkilöitä on oltava yhteensä vähintään yksi.
Kun käytät baseVie-ryhmässä usageBungalow-kenttää, jätä chantier pois. Jos ilmoitat kunnon etat-kentässä, sallitut arvot ovat neuf, occasion ja peuImporte.
Käytä lieuStockage-kenttää vain, kun famille on stockage. Jos ilmoitat kentän oston yhteydessä, käytä arvoa surSite. Kentät projetAmenage ja usageAmenage kuuluvat vain ryhmään amenage. Kentät regimeFroid ja temperatureCible kuuluvat vain ryhmään frigorifique. Työmaatiedot kuuluvat vain ryhmään baseVie.
Käytä etat-kentässä arvoa peuImporte, jos asiakas ei rajaa kontin kuntoa. JSON-kuvauksessa arvo näkyy nimellä ”Suositeltava”.
Kuvaus sisältää myös seuraavat kentät. Osa niistä on yllä mainituissa tilanteissa pakollisia. Tarkista kunkin kentän tyyppi, pituus, sallitut arvot ja ehdot ajantasaisesta JSON-kuvauksesta.
etatusageBungalowlieuStockageprojetAmenageusageAmenageregimeFroidtemperatureCibledureeMoischantiercommunedateSouhaiteeacceslevageSurPlaceraccordElecraccordEauraccordAssainissementprecisionssocieteIlmoita tavoitelämpötila celsiusasteina merkkijonona kentässä temperatureCible, esimerkiksi "-18". Käytä enintään kahta desimaalia. Sallittu vaihteluväli on −80…+40 °C. Hyväksytty arvo ei takaa tietyn kylmäkontin suorituskykyä.
Alla on GET-kuvauksen esimerkkipyyntö. Korvaa esimerkkitiedot asiakkaan hyväksymillä tiedoilla ennen lähettämistä. Älä lähetä esimerkkiä sellaisenaan. Tuotantorajapinnan POST-pyyntö voi tallentaa oikean tarjouspyynnön.
Vieritä koodia tarvittaessa sivusuunnassa.
{
"famille": "achat",
"mode": "achat",
"format": "20DRY",
"quantite": 1,
"codePostal": "00100",
"commune": "Helsinki",
"prenom": "Test",
"nom": "Example",
"email": "test\u0040example.com",
"consentement": true,
"consentementQuotboxAgent": "quotbox-marketplace-v1",
"telephone": "+358400000000"
}JSONissa @-merkin voi kirjoittaa myös muodossa \u0040. Jäsennetty sähköpostiosoite on sama kummallakin tavalla. Rajapinta ei edellytä tätä esitystapaa.
Lue sekä HTTP-koodi että vastauksen JSON-sisältö. Kenttä reference yksilöi tallennetun pyynnön. Erityisesti 202- ja 502-vastauksissa pyyntö on jo tallessa, vaikka välitystä ei ole vahvistettu.
Pyyntö on tallennettu ja välitetty Quotboxille. Säilytä pyynnön viite (reference). Vastaus ei ole toimittajan tarjous eikä vahvista saatavuutta.
Vastauksessa enregistree on true, transmis on false ja etat on en_attente. Säilytä pyynnön viite (reference). Älä luo samaa pyyntöä uudelleen.
Tarkista, että pyynnön sisältö on kelvollista UTF-8-koodattua JSONia. Tarkista myös mahdollinen Content-Length-otsake.
Tarkista yhteys. Palvelimen on saatava luettua pyynnön sisältö 10 sekunnissa.
Pyynnön sisältö saa olla enintään 32 KiB (32 768 tavua).
Käytä Content-Type: application/json ja UTF-8-koodausta.
Tarkista vaaditut kentät, arvot ja tuoteryhmän ehdot. Jos vastauksessa on champs-lista, se kertoo, missä kentissä on virheitä. Lue myös vastauksen viesti.
Odota Retry-After-otsakkeen ilmoittama sekuntimäärä ennen uutta yritystä.
Vastauksessa enregistree on true ja etat on action_requise. Säilytä pyynnön viite (reference) ja ota yhteyttä ContainerFjordiin. Älä luo samaa pyyntöä uudelleen.
Vastaanotto voi olla poissa käytöstä tai tallennus voi epäonnistua. Tarkista vastauksen tiedot. Jos pyynnön tila jää epäselväksi, ota yhteyttä ContainerFjordiin.
Jos et saa vastausta, pyyntö on silti voinut tallentua. Selvitä sen tila ContainerFjordin kanssa ennen kuin lähetät saman pyynnön uudelleen. Ilmoita pyynnön viite, jos se on tiedossasi.
Päivitetty . Tarkista rajapinnan ajantasaiset ehdot GET-kuvauksesta.