API

Wat API-toegang op dit moment inhoudt bij Worldwatch, en waarom er op deze pagina geen openbare documentatie staat.

Wat er vandaag is

API-toegang staat op prijzen vermeld als onderdeel van het Enterprise-abonnement. In de praktijk betekent dat een afspraak met ons in plaats van een sleutel die u zelf via een instellingenscherm aanmaakt, en wat die afspraak omvat, wordt afgestemd op het vraagstuk dat wordt opgelost.

De interface die de applicatie zelf gebruikt, is per handelaar geauthenticeerd en is niet gedocumenteerd voor derden. Het is geen stabiel contract, hij verandert wanneer het product verandert, en alles wat erop gebouwd wordt, breekt zonder aankondiging. Dat is de eerlijke reden dat hier geen documentatie staat, in plaats van onvolledige documentatie.

Wat een openbare API zou moeten regelen

Authenticatie, en hoe een handelaar toegang verleent aan software van iemand anders. Welke gegevens beschikbaar worden en welke intern blijven. Wat gegarandeerd niet verandert, en voor hoe lang. Hoe een wijziging wordt aangekondigd. Die vier zijn het verschil tussen een API en een endpoint, en geen ervan is beantwoord.

Bouwt u iets

Laat weten wat u probeert te koppelen. Een concrete koppeling met een klant die u bij naam kan noemen, is wat dit van een plan naar een toezegging brengt, en het is ook de enige manier om erachter te komen of Enterprise-toegang al dekt wat u nodig hebt.

Voor de kanalen waarmee Worldwatch namens een handelaar koppelt, waar de meeste integratievragen uiteindelijk over blijken te gaan, staat de lijst op integraties.