EKO3-1: společný inbox v OnPass

Upozornění ze všech projektů se zobrazí na jednom místě, v Upozorněních OnPass, vedle bezpečnostních upozornění.

Příjem staví onhost-id za příznakem features.inbox, který je ve výchozím stavu vypnutý. Kontrakt je v tomto repozitáři:

schéma: schemas/ecosystem/inbox-item.v1.json, ukázka fixtures/onpass-inbox-item.json;
odeslání z projektu: POST https://onpass.cz/api/v1/inbox/items s autentizací client_secret_basic (klient potřebuje

v OnPass povolení allow_inbox, scope v metadatech onpass.inbox.write). Sběrnice zatím ne, je v plánu;

kit: Onhost\EcosystemKit\Inbox\InboxItem zkontroluje položku ještě před odesláním. SDK nabízí

OnPassClient::createInboxItem($item->toArray(), ['Authorization' => 'Basic …']).

Odpovědi:

Kód · Kdy

202 · Přijato. Stejně odpoví i na neznámý sub nebo na uživatele, který klienta nepropojil, a nic nezapíše, aby nešlo zjišťovat, které účty existují.

200 · Stejné id přišlo znovu. Idempotence se počítá podle (client_id, id).

422 · Chyba schématu.

429 · Překročen limit 60 požadavků za minutu na klienta.

Pravidla:

url musí být na hostu z redirect_uris klienta;
expires_at může být nejvýš 90 dní dopředu. Položka bez něj se po 90 dnech smaže;
položka se stejnou skupinou (group, klíč client_id + sub + group) nahradí starší a znovu se ukáže jako nepřečtená;
službu, od které položka je, odvodí OnPass z client_id.

Uživatel může upozornění konkrétní služby ztlumit. Položky se exportují a smažou spolu s účtem.