Lumina

Centar za pomoć

Integrations

Integracije su način na koji Lumina objavljuje vaše gotove nacrte na mjesta koja vaša publika doista čita. Odredište povežete jednom po brendu, i od tada možete poslati (push) bilo koji spreman nacrt izravno na njega. Veze se uređuju u odjeljku Integracije na nadzornoj ploči.

<!-- screenshot: Stranica Integracije s popisom dostupnih odredišta i njihovim statusom -->

Podržana odredišta

Lumina danas dolazi s tri odredišta za objavljivanje:

OdredišteŠto povezujeteŠto vam treba
WordPressSamostalno hostanu ili WordPress.com stranicu putem REST API-jaURL stranice, korisničko ime i Application Password
GhostGhost stranicu putem Admin API-jaAdmin API URL i Admin API ključ (id:secret)
Webhook / Custom RESTBilo koju HTTP krajnju točku kojom upravljateURL krajnje točke i tajni potpis (signing secret)

Svako odredište je veza po brendu, povezivanje WordPressa za jedan brend ne povezuje ga za ostale. Pogledajte Radni prostori i brendovi.

Objavljivanje je značajka ovisna o planu. Ako ne vidite Integracije ili akciju Pošalji (Push), provjerite svoj plan u Krediti i naplata.

Povezivanje odredišta

  1. Idite na Integracije i odaberite vrstu odredišta.
  2. Ispunite njegova polja (vidi niže). Tajna polja, lozinke, API ključevi, tajni potpisi, šifrirana su u mirovanju i maskirana svaki put kada ponovno pregledate vezu.
  3. Lumina pokreće test veze kako bi potvrdila da vjerodajnice rade prije spremanja.
  4. Veza se prikazuje kao Aktivna kada je ispravna, ili Greška ako kasnija provjera ne uspije (primjerice, ako rotirate ključ na odredištu).

Test možete ponovno pokrenuti u bilo kojem trenutku, povezati se s novim vjerodajnicama ili u potpunosti odspojiti odredište.

<!-- screenshot: Dijalog za povezivanje WordPressa s maskiranim poljem Application Password -->

WordPress

Lumina objavljuje putem WordPress REST API-ja koristeći Application Password (ne vašu lozinku za prijavu). U WordPressu idite na Korisnici → Profil → Application Passwords, izradite jednu za Luminu i zalijepite je ovdje zajedno s URL-om stranice i korisničkim imenom.

Ghost

Lumina koristi Ghost Admin API. U Ghostu izradite Custom Integration (Settings → Integrations → Add custom integration) kako biste dobili Admin API ključ u obliku id:secret, te Admin API URL. Zalijepite oboje ovdje.

Webhook / Custom REST

Za sve ostalo, usmjerite Luminu na URL krajnje točke kojom upravljate. Pri objavljivanju Lumina šalje JSON POST koji opisuje sadržaj, potpisan zaglavljem X-Lumina-Signature: sha256=… izvedenim iz vašeg tajnog potpisa, kako bi vaš primatelj mogao provjeriti da je zahtjev autentičan. Pri testiranju veze šalje se događaj ping.

Objavljivanje nacrta

Kada je odredište povezano i nacrt je Spreman, koristite Pošalji (Push) u uređivaču ili prikazu nacrta da ga pošaljete. Lumina:

  • Šalje naslov i tijelo, kao objavljenu objavu (ili zakazanu, ako postavite vrijeme objave).
  • Bilježi rezultat, ID objave na odredištu i poveznicu za pregled.
  • Označava objavu objavljeno ili neuspjelo, uz grešku ako nešto pođe po zlu, kako biste mogli popraviti vezu i pokušati ponovno.

Cijeli životni ciklus nacrta pogledajte u Nacrti i objavljivanje.

Rješavanje problema

  • Veza prikazuje Greška: ponovno pokrenite test. Najčešći uzroci su rotirani API ključ, istekla Application Password ili promijenjen URL stranice. Povežite se s novim vjerodajnicama.
  • WordPress ne uspijeva: potvrdite Application Password (ne lozinku za prijavu) i da je REST API dostupan na …/wp-json/.
  • Ghost ne uspijeva: potvrdite da je ključ cijeli id:secret Admin API ključ i da URL upućuje na vašu Ghost admin domenu.
  • Webhook ne uspijeva: potvrdite da vaša krajnja točka vraća 2xx status za događaj ping i da provjerava zaglavlje X-Lumina-Signature.

Što je sljedeće za integracije

Model veze izgrađen je tako da raste, odredišta su modularna (pluggable), a OAuth prijava (kako za neke platforme ne biste morali lijepiti ključeve) na je planu razvoja. Nova odredišta automatski se pojavljuju na popisu Integracija kako se isporučuju.

Pogledajte i