Te same operacje
To, co robicie na ekranie, robicie wywołaniem: witryny, treści, obrazy, motywy, menu, przekierowania, publikacja, Search Console. Dokumentacja wymienia każdą operację, jedna po drugiej.
Programiści
Joornal steruje się przez API
Wszystko, co robi panel administracyjny, można zrobić także przez API: utworzyć witrynę, zaimportować treści, opublikować, odczytać dane Search Console. Waszymi narzędziami, w waszych procesach, z tymi samymi uprawnieniami co wasi użytkownicy.
To samo co interfejs, bez interfejsu
To API nie jest podzbiorem udzielonym niechętnie. To ta sama aplikacja, widziana z drugiej strony.
Te same uprawnienia
Token sięga wyłącznie zakresu swojego posiadacza: jego klienta, jego projektów, jego witryn. Zasób poza nim odpowiada 403. Nie ma osobnego „konta API” z własnymi regułami, które trzeba utrzymywać.
Bez sesji, bez ciasteczka
Jeden nagłówek X-API-TOKEN na wywołanie, sprawdzany za każdym razem. Nic do otwierania, nic do odnawiania, nic do przechowywania w przeglądarce.
Błędy, które wyglądają tak samo
Jeden kontrakt błędu w całym API: stabilny kod maszynowy, czytelny komunikat i szczegóły pole po polu, gdy walidacja się nie powiedzie. Obsługę błędów piszecie raz.
Czym sterujecie
Zastosowania, które najczęściej pojawiają się w agencjach i grupach wielomarkowych.
Zasilanie z waszych systemów
Masowy import treści, idempotentny: powtórzenie tego samego wywołania nie tworzy duplikatów, a wy decydujecie, czy zostawia istniejące w spokoju, czy je aktualizuje. Możecie datować wstecz, zaplanować publikację, przypisać kategorie i sygnatariuszy oraz wysłać obrazy w tym samym ruchu.
Przejęcie istniejącej witryny
Migracja z WordPressa lub z eksportu, a potem uruchomienie: motyw, domena, przekierowania, mapa witryny. Portfel witryn tworzy się i konfiguruje wywołaniem, nie zgłoszeniem.
Publikacja we właściwym momencie
Uruchomić publikację, przeplanować kolejkę artykułów, śledzić postęp. Długie operacje zwracają identyfikator zadania, które odpytujecie aż do końca.
Odzyskanie danych
Wyniki Search Console per artykuł, stan indeksacji adres po adresie, statystyki wizyt robotów, kontakty z formularza. Żeby zasilać wasze pulpity zamiast je przepisywać.
Na co możecie liczyć
API, które się podłącza, to API, którego reguły zna się z góry. Nasze są zapisane w dokumentacji, a nie w umowie, o którą trzeba poprosić.
Rok po wycofaniu
Pole lub operacja przeznaczone do usunięcia są najpierw oznaczone w specyfikacji, wraz z następcą i datą oznaczenia. Są serwowane jeszcze przez co najmniej rok od tej daty. Zawsze macie pełny rok na przejście.
Specyfikacja, która nie kłamie
Specyfikacja OpenAPI jest publiczna, a nasza ciągła integracja odrzuca każdą zmianę API, której nie towarzyszy aktualizacja dokumentacji. Dokumentacja nie może po cichu zostać w tyle: pokazuje datę swojej ostatniej weryfikacji.
Zapowiedziane limity
Każda odpowiedź niesie pozostały wam limit. Nigdy nie musicie odkrywać limitu, uderzając w niego, i możecie zwolnić, zanim was zatrzyma.
Nieznany filtr jest odrzucany
Błędnie zapisany lub wycofany parametr daje błąd, nigdy wynik, który tylko wygląda na poprawny. To rodzaj szczegółu, który zauważa się dopiero w dniu, w którym kosztował już tydzień.
Odzyskaj kontrolę nad swoją widocznością
Umów spersonalizowane demo i zobacz, jak zbudować serwis medialny uporządkowany, skuteczny i oparty na danych.