Dla deweloperówPublikuj wszędzie, gdzie masz własny system.
Własny cel publikacji to sieć, o której Ocoya nie musi nic wiedzieć. Podaj URL, a otrzyma on gotową treść jako JSON — tak samo jak post trafia na Instagram, tylko że po drugiej stronie jesteś Ty.
Cel publikacji dla całej reszty.
Większość publikacji trafia do sieci z logo. To jest dla wszystkiego innego.
Twój własny blog
Artykuły napisane w Ocoya trafiają do CMS-a, którego już używasz — Ghost, Strapi, Sanity albo coś własnego.
Sieć, której nie obsługujemy
Odbierz post i przekaż go dalej sam. Do wszystkiego, co ma API, dotrzesz własnym kodem.
Własny etap akceptacji
Kieruj opublikowane treści do kolejki recenzji, kanału na Slacku lub arkusza, zanim trafią gdziekolwiek indziej.
Twoje własne archiwum
Trzymaj kopię wszystkiego, co opublikowano, w swojej hurtowni danych, bez odpytywania API.
URL, nazwa i zwykle jeden nagłówek.
Nie ma żadnego tańca z OAuth, bo oba końce należą do Ciebie. Wklej adres, dodaj nagłówek, którym uwierzytelnia się Twój endpoint, a cel pojawi się w edytorze obok Twoich profili społecznościowych.
- Dowolny URL, który przyjmuje POST i odpowiada 2xx
- Nagłówki dla dowolnej metody uwierzytelniania Twojego endpointu
- Pojawia się w edytorze jak każdy inny profil
Połącz własny cel publikacji
Nazwa
URL webhooka
Opcje zaawansowane
Cztery kroki i żaden nie zajmuje tygodnia pracy dewelopera.
Przygotuj miejsce odbioru
Dowolny URL, który przyjmuje POST z treścią JSON i odpowiada 2xx. Musi być dostępny z internetu — Ocoya łączy się z nim ze swoich serwerów, nie z Twojej przeglądarki.
Dodaj cel publikacji
Integrations → Custom. Nadaj mu nazwę, którą rozpoznasz w edytorze, i wklej URL.
Dodaj nagłówek, jeśli jest potrzebny
W Opcjach zaawansowanych dodaj nagłówek, którym uwierzytelnia się Twój endpoint — zwykle Authorization lub X-API-Key. Jest przechowywany w postaci zaszyfrowanej i nigdy nie wraca do przeglądarki.
Publikuj jak w sieci
Cel pojawia się w edytorze obok Twoich profili społecznościowych. Zaplanuj post albo skieruj na niego kampanię blogową, a otrzyma wszystko, co zapisał edytor.
Jeden POST, z tym, czego potrzebuje blog.
Treść to JSON: tytuł, opis dokładnie tak, jak go napisano — w Markdownie, jeśli to artykuł — jedno zdjęcie okładkowe oraz slug, zajawka, tagi i pola SEO artykułu, jeśli je ma. Nic więcej, więc nie ma czego ignorować.
- Content-Type: application/json oraz dodane przez Ciebie nagłówki
- caption to treść w oryginalnej formie; title i image są osobno
- post.id jest taki sam przy ponownych próbach, więc możesz aktualizować zamiast duplikować
Odpowiedz kodem 2xx, a Ocoya oznaczy post jako opublikowany. Każda inna odpowiedź zostanie Ci pokazana wraz z treścią zwróconą przez endpoint.
Każde pole, z typem
Slug, zajawka, pola SEO, tagi i czas czytania, które niesie artykuł — czym jest każde z nich i których post społecznościowy nie zawiera.
To Twój endpoint, łączony z rozwagą.
Cel publikacji to adres, z którym łączymy się z własnej sieci, więc traktujemy go z należytą ostrożnością.
Adresy prywatne i wewnętrzne są odrzucane, a połączenie jest przypięte do adresu, na który się rozwiązał.
Przekierowanie jest wykonywane dopiero, gdy nowy adres przejdzie tę samą kontrolę.
Twoje nagłówki są przechowywane w postaci zaszyfrowanej i nigdy nie są odsyłane do przeglądarki.
Cokolwiek odpowie Twój endpoint, widać w dzienniku aktywności, razem z treścią.
Publikuj tam, gdzie powinno trafić.
Połącz cel publikacji w minutę i skieruj na niego kolejną kampanię.