Dezelfde bewerkingen
Wat u op het scherm doet, doet u met een aanroep: sites, content, afbeeldingen, thema’s, menu’s, omleidingen, publicatie, Search Console. De documentatie somt elke bewerking op, stuk voor stuk.
Ontwikkelaars
Joornal stuurt u aan via de API
Alles wat de back-office doet, kan ook via de API: een site aanmaken, content importeren, publiceren, Search Console-gegevens uitlezen. Met uw eigen gereedschap, in uw eigen ketens, met dezelfde rechten als uw gebruikers.
Hetzelfde als de interface, zonder de interface
Deze API is geen met tegenzin toegestane deelverzameling. Het is dezelfde toepassing, vanaf de andere kant bekeken.
Dezelfde rechten
Een token reikt niet verder dan het bereik van de houder: diens klant, diens projecten, diens sites. Een bron daarbuiten antwoordt 403. Er is geen apart „API-account” met eigen regels die u moet bijhouden.
Geen sessie, geen cookie
Eén X-API-TOKEN-header per aanroep, elke keer opnieuw gecontroleerd. Niets te openen, niets te vernieuwen, niets in de browser te bewaren.
Fouten die op elkaar lijken
Eén foutcontract voor de hele API: een stabiele machineleesbare code, een leesbare boodschap en de details veld voor veld wanneer een validatie mislukt. U schrijft de foutafhandeling één keer.
Wat u aanstuurt
De toepassingen die het vaakst terugkomen bij bureaus en multimerkgroepen.
Voeden vanuit uw eigen systemen
Bulkimport van content, idempotent: dezelfde aanroep opnieuw uitvoeren maakt geen dubbels, en u bepaalt of hij het bestaande met rust laat of bijwerkt. U kunt terugdateren, een publicatie inplannen, categorieën en ondertekenaars koppelen, en de afbeeldingen in dezelfde beweging meesturen.
Een bestaande site overnemen
Overname vanuit WordPress of vanuit een export, daarna de livegang: thema, domein, omleidingen, sitemap. Het portfolio wordt per aanroep aangemaakt en ingericht, niet per ticket.
Publiceren op het juiste moment
Een publicatie starten, een wachtrij artikelen opnieuw inplannen, de voortgang volgen. Lange bewerkingen geven een taak-id terug die u bevraagt tot hij klaar is.
De gegevens terughalen
Search Console-prestaties per artikel, indexeringsstatus URL voor URL, statistieken over crawlerbezoek, leads uit het formulier. Om uw eigen dashboards te voeden in plaats van ze over te tikken.
Waarop u kunt rekenen
Een API die u aansluit, is een API waarvan u de regels vooraf kent. De onze staan in de documentatie, niet in een contract dat u moet opvragen.
Een jaar na de uitfasering
Een veld of een bewerking die gaat verdwijnen, wordt eerst gemarkeerd in de specificatie, met de opvolger en de datum van de markering. Ze blijven minstens een jaar vanaf die datum beschikbaar. U hebt altijd een vol jaar om over te stappen.
Een specificatie die niet liegt
De OpenAPI-specificatie is openbaar, en onze continue integratie weigert elke wijziging van de API die niet samengaat met het bijwerken van de documentatie. De documentatie kan niet stilzwijgend achterlopen: ze toont de datum van haar laatste herziening.
Aangekondigde limieten
Elk antwoord draagt het tegoed dat u nog hebt. U hoeft een limiet nooit te ontdekken door ertegenaan te lopen, en u kunt afremmen voordat hij u stilzet.
Een onbekend filter wordt geweigerd
Een verkeerd gespelde of afgeschafte parameter levert een fout op, nooit een resultaat dat er alleen maar juist uitziet. Dat is het soort detail dat u pas opmerkt op de dag dat het u een week heeft gekost.
Neem de regie over uw zichtbaarheid terug
Plan een demo op maat en ontdek hoe u een mediasite bouwt die gestructureerd en effectief is, en op data draait.