Inleiding
RFH Insights biedt heel veel mogelijkheden om onderzoek te doen naar de prijsontwikkeling van producten op de klok via het Marktbeeld.
Toch zijn er ook gebruikers die deze data graag in eigen rapportages of in de eigen applicatie willen gebruiken, bijvoorbeeld voor het zelf automatisch bepalden van een verkoop strategie.
Voor dit specifieke doel zijn er een aantal API's ontwikkeld, waarmee een kweker of koper gemiddelde prijzen van geveilde producten kan ophalen. De kweker heeft daarbij de keuze om dat alleen te doen voor de producten waarbij die hij zelf verkoop op de klok, of om dit voor zelf te bepalen productgroepen in zijn geheel op ote halen.
Het recht om gebruik te maken van deze API's is gekoppeld aan een RFH Insights abonnement.
Documentatie over de API
De technische documentatie met wat er exact als parameter meegegeven kan worden, en welke gegevens de API's terug geven kan je vinden via de volgende link:
Je vind hier 3 verschillende functies:
average-auction-prices: deze functie geeft voor ieder geveild product, per locatie en hoofdkenmerk de gemiddelde veilingprijs terug. Geveilde aantallen worden ook meegeven als er drie of meer veschillende aanvoerders zijn. Voor deze functie is een RFH Insights Light abonnement voldoende.
average-auction-prices-overview: hiermee kan per productgroep de gemiddelde prijzen per locatie/product/hoofdkenmerk worden opgehaald. Ook hier geldt de drie kweker regel. Deze functie vereist minimaal een RFH Insights Basis abonnement.
buyers/average-auction-prices: dezelfde optie als hierboven, maar dan alleen beschikbaar voor klanten met een koper abonnement. Aantallen worden alleen gedeeld bij kopers als er meer dan vijf verschillende aanvoerders zijn.
Om overvraging en daardoor overbelasting te voorkomen, wordt gebruik gemaakt van een rate limit op de API functies.
Van maandag tot en met vrijdag tussen 06.00 en 12.00 uur kan iedere 5 seconden één aanroep worden gedaan. Op alle tijdstippen daarbuiten, kan dat één keer per seconde.
Gebruik maken van API's
Het koppelen aan RFH Insights API's werkt gelijk aan het koppelen aan de API's van Floriday zelf. Veel software bedrijven in de sierteelt hebben al toegang en maken al gebruik van deze API's. Dat werkt via een eigen unieke sleutel (ClientID).
Meer informatie over welke bedrijven er al actief zijn, of hoe een bedrijf zich hiervoor kan aanmelden vind je bij de volgende links:
Hoe doe je een aanroep?
Als je gebruik wil maken van een API heb je een token nodig. Een token kan door de leverancier (met zijn ClientID) worden opgevraagd.
Naast het token is ook een API-key nodig. Als een kweker of koper in Floriday koppelt aan een bepaalde softwareleverancier, kan de API-key die dan wordt gemaakt hiervoor worden gebruikt. De API-key geeft dan aan, voor welke organisatie de API-aanroep wordt gedaan.