Arrangementer

Dette kan du bygge

En arrangementsside som forteller låneren om arrangementet er noe for dem: når og hvor det er, hva det koster, og hvordan man kommer med. Krever det billett eller påmelding, har arrangementet en lenke, en e-post, et telefonnummer eller en veiledning. Siden kan også vise de andre datoene i en serie og verkene som hører til arrangementet.

Typisk flyt

1. Klienten henter arrangementet med GetContentEvents og id-en i event_ids.
2. Siden viser tittelen, tiden fra scheduling, stedet fra branch og location, og adgangen fra admission.
3. Hører arrangementet til en serie, henter klienten de andre arrangementene med GetContentEventsInSeries og series.seriesId.
4. Relaterte verk kommer fra GetWorks når relevantWorks har workIds, eller fra SearchWorks når det angir en query.
5. Låneren åpner et verk (1.2.1) eller et annet arrangement i serien.

Dette leverer API-et

• state er scheduled, cancelled eller finished.
• scheduling er all_day med startDate og endDate, eller time_span med startTime og endTime.
• location er at_branch, et sted inne på filialen, eller external med et name og en valgfri address.
• admission er open, ticket eller registration. Billett og påmelding har contactInfo med minst ett av url, email, phone eller info, og en state: ticket_sale_not_open, ticket_sale_open, almost_sold_out eller sold_out.
• En billett har pricing: simple med en tekst, eller price_categories med et amount i minste myntenhet og en currency i ISO 4217. Et amount på 0 betyr at arrangementet er gratis, men billetten kreves fortsatt.
• Bare description kan ha formatering, og bare med HTML-taggene b, i, p, a, ul, ol og li.

Dette kan du bygge

En arrangementskalender som viser bibliotekets arrangementer dag for dag, hvert med tittel, tid, filial og pris. Filtre for filial, kategori og målgruppe bygges av arrangementene selv.

Typisk flyt

1. Klienten henter arrangementene i en periode med GetContentEvents, from_date og to_date.
2. Klienten blar gjennom resultatet med page og size til endOfResults er sann.
3. Klienten grupperer arrangementene per dag og lar låneren filtrere på branch, categories og audiences.
4. Låneren åpner et arrangement (3.2.1).

Dette leverer API-et

• En forespørsel må ha enten to_date eller event_ids. Uten from_date starter provideren fra i dag i sin egen tidssone.
• size er høyst 50. total er antallet arrangementer i hele perioden.
• GetContentEvents har ingen parametre for filial, kategori eller målgruppe. Klienten filtrerer på feltene i hvert arrangement.
• promoted markerer et arrangement som fremhevet, eventuelt mellom en startTime og en endTime.
• Uten ui_language returneres hvert arrangement på alle språkene det finnes på. Samme id på flere språk er ett arrangement. GetContentConfiguration viser hvilke språk provideren støtter.