For utviklere
Full dokumentasjon over vår API på: https://developers.recman.no/.
Generering av en API-nøkkel og API-URL
API-nøkkel og API-URL genereres av en systemadministrator i RecMan, under Systeminnstillinger → Database → API → Opprett. Når du har fått tildelt en API-nøkkel, har du muligheten til å definere dine egne feeder, for eksempel en feed for stillingsannonser.
Hvordan lage en API-nøkkel i RecMan
API-tilgang
Når API-tilgang er opprettet, har du også muligheten til å begrense API-nøkkelen din ved å bestemme hvilke operasjoner og moduler den skal ha tilgang til. Dette kan være lurt når webutviklingen din utføres av et eksternt selskap, og du ikke vil at de skal ha tilgang til hele databasen din.
For utviklere
Caching
Pris
Vær oppmerksom på at RecMan API har maksimalt 200 forespørsler per dag (tilbakestilt ved midnatt) gratis. Ta kontakt med support@recman.no for prisliste.
Vi anbefaler derfor å cache feeden din i ditt eget system, for å unngå oppslagsgrensen på 200.
En løsning her er å laste ned json-filen, og tidsstemple den. Et skript kan sjekke tidsstempelet med jevne mellomrom, og når tiden overstiger en angitt grense, henter systemet en ny fil.
En annen løsning er å begrense oppslagene om natten. Ved å begrense dette kan du isteden ha høyere frekvens om dagen, og bruke en lagret fil som kilde om natten.
Uansett anbefales det å sette en grense på 200 oppslag per 24 timer.
URLer
Når du utfører en GET, bruk url https://api.recman.no/v2/get/
Når du utfører en POST, bruk url https://api.recman.no/v2/post/
Når du har API-nøkkelen og API-URL, kopierer du dem og sender dem til webutvikleren din.
Sikkerhet
APIen vår støtter ikke «Access-Control-Allow-Origin». Siden dette i utgangspunktet vil bety at enhver operasjon på klientsiden vil avsløre API-nøkkelen din, så har vi besluttet å ikke aktivere denne funksjonen.
Eksempler
I eksemplene i artiklene våre bruker vi et plugin for Chrome som heter Postman.
Bruksområder for API
I dokumentasjonen finner du eksempler og forklaringer på de mest brukte løsningene. Alle unntatt en av disse løsningene bruker API-et vårt for å fungere.