Friends of OpenJDK Today

Introducing the Foojay.io Calendar API

June 22, 2023

Author(s)

  • Slava Shevchenko

    Product Owner at Foojay and Head of Sales at YELK team. Passionate about providing more tools for Foojay and growing the Java community.

We are excited to share that Foojay is growing and offering additional resources to bring the Java and OpenJDK community together on a global scale.

Several months ago, we launched the Foojay Calendar, an interactive platform that allows individuals to propose Java-related and Kotlin-related and any other OpenJDK-related events and add them to the calendar.

All Foojay members are welcome to submit their events. Once reviewed, the event will be included in the calendar.

Although many users loved the idea, several organizations that provide their own event platforms reached out to us and asked if they could integrate their own events database into our calendar directly.

During our latest collaborations, we integrated events from JUG Switzerland, thanks to Patrick Baumgartner, and Adoptium with the Eclipse Foundation, thanks to Carmen Delgado.

We have expanded our API capabilities and now allow anyone to send their own events.

Our hope is that this change will keep the OpenJDK community engaged and informed about relevant events happening worldwide.

Promoted Content

Root Cause: DB query with a scaling issue

Encountered performance issues and unexpected behavior in your backend services?

Get Insights

How to add your events

We welcome inquiries from organizations interested in connecting with us.

You can reach us at [email protected] or via Foojay Slack.

If you have events to share but lack development capabilities, our team is happy to assist with integration setup.

1. Registering as an External Source and Getting an API Key

Other organizations that want to use our API directly and send events via an endpoint can follow the instructions below.

  1. To get started, you'll need to retrieve your source and generate a unique API key. Please note that only Contributors and Admins currently have permission to complete this step. If you don't fall into either of these categories, please reach out to us so we can grant you the necessary permissions.
  2. To obtain an API key and register your source, kindly send a request to [email protected] or via Foojay Slack with the subject line "API key". Our Foojay calendar administrator will then generate your API key and add you to our system as a trusted vendor.
  3. Provide additional information about your organization, including its name, description, and details about the types of events it will host.
  4. Once the Foojay Calendar admin generates your API key, you can use it to access the Foojay Calendar API.

2. Working with an API endpoint

Now you can work with our endpoint.

Endpoint: https://foojay.io/wp-json/foojay/v2/calendar/

Method: POST

The endpoint is used to create new events on the Foojay Calendar. Any newly added events will be saved as drafts and will be published only after approval by the website administrator.

To send data to the endpoint, use the FormData format.

Below is an example of adding a new event in Postman:

  • Mandatory fields are marked with an asterisk (*).
  • The 'source' field is used along with a custom HTTP header to restrict the external sources from which events can be added.

To add your API key, use the "calendar-key" HTTP header. Make sure you have already generated an API key and source name, which should have been provided by the Foojay admin.

3. Responses

Once the event has been successfully added, you’ll receive a 201 code and event ID:

If there is an issue, you will receive a response with a 4xx code:


Example on the Frontend

Below is a description of the API fields and their corresponding elements on the front-end.


Example Based on an Existing Event

The following is a real imported event provided by https://adoptium.net/:

If you encounter any problems or have any questions, please reach out to us at [email protected] or on the Foojay Slack.

Topics:

Related Articles

View All

Author(s)

  • Slava Shevchenko

    Product Owner at Foojay and Head of Sales at YELK team. Passionate about providing more tools for Foojay and growing the Java community.

Comments (0)

Your email address will not be published. Required fields are marked *

Highlight your code snippets using [code lang="language name"] shortcode. Just insert your code between opening and closing tag: [code lang="java"] code [/code]. Or specify another language.

Save my name, email, and website in this browser for the next time I comment.

Subscribe to foojay updates:

https://foojay.io/feed/
Copied to the clipboard