#EPU 3: Simplifying the Ingest API 🤯
One of the core pillars of Enterspeed is the ability to get your data into our Headless Hub. It's quick and easy to do, using one of our integrations or our ingest API.
But here at Enterspeed, the developer is king 👑, so we want to make it even easier and quicker to ingest data.
So sit back and let us blow ya mind, like were we Eve & Gwen Stefani.
feature Ingest API V2 📤
In version 1 of our Ingest API, you had to specify the type of all properties, which looked something like this.
In version 2 of our Ingest API we have made this much more simple, by automatically detecting types based on the data itself. This means that the code above can be reduced to this:
Quite the improvement, huh? But wait, there's more (As the late Billy Mays would have put it).
When ingesting data into Enterspeed, a requirement is that you specify originId and type. You can also pass along URL, redirects, etc.
However, not everybody is able to manipulate the data to also include these properties, which is why we give you the option to ingest RAW data in and specify the type, URL, redirects, etc. in the headers, reducing the above code to this:
Mind = blown 🤯
You can read more about it in our documentation here: Enterspeed Ingest API.
💡 V1 of the Ingest API is still supported, however, we recommend you use the new V2.
feature Umbraco integration upgrade - preview changes 🔎
As a company building a high-performing headless hub, you may be shocked when we say: Headless is the future.
But, working in a headless environment isn't always a cakewalk. Tasks like previewing content before publishing it can sometimes be cumbersome, to say the least.
BUT NOT ANYMORE, BABY!! 🎉🎊
Ahem, sorry I got carried away. I mean... This isn't the case anymore.
Our updated Umbraco-integration (which is right around the corner) now enables preview mode!
Yes, you read that right. You're now able to insert a preview API key under configuration.
To get the Preview API key, create a new data source in Enterspeed that stores your preview data. This enables you to setup an internal site / URL for your content creators, which fetches the preview data.
Now, every time one of your creators saves new content, they can view it on their internal site / URL. When they're ready to share it with the world, they simply hit publish and it will be available to the world 🌍.
feature See when source entities have been updated 🕐
When working with your source entities it can be useful to see when the data was last updated - especially if you're trying to debug something (e.g. a custom script for ingesting data).
We've added the "Updated"-column in the source entities table, which tells you when the data was last updated.
feature Avoid losing unsaved schema changes 😱
Losing unsaved changes. Just saying the words can trigger any developer's anxiety.
It's so frustrating that even pounding the instant "Nooooooooooooooo"-button multiple times won't make you feel any better.
Close your eyes, take a deep breath, and calm yourself again. We're not going to let this happen to you. Not on our watch.
If you have unsaved changes in your schema and try to navigate away, you'll now be met with a warning:
Still got anxiety? Here's a link to "The Best of ENYA | Non-Stop Playlist". Take a break and come back when you're ready. We'll be here.
feature Duplicate schema 👯
When working with schemas, you may want to reuse some of the code from another schema. No problem!
You can now duplicate a schema by clicking on the settings menu (three dots) in the schema table and selecting "Duplicate". Easy 🙌
feature Chat support 💬
We'll be there for you 🎵
We have implemented chat support in both our app and on Enterspeed.com, so it's easy for you to get help if you should get stuck or have any questions.
Improvement New visual identity 🎨
Just like Maria from West Side Story, you can say we "feel pretty, oh so pretty... 🎵".
You may have noticed our new visual identity in both our App, documentation, sign in, and website (Enterspeed.com)💅
We're very pleased with this new identity, which gives the whole app and experience a much "lighter feeling" than the old dark-blue color.
Improvement Improved schema reference documentation 📄
"Did you read the docs?" asking a developer this question is equivalent to a tech supporter asking "Have you tried turning it off and on again?". 🤔
There's a reason for this. Just like rebooting your device often can fix bugs, reading the documentation for a piece of software can save you so much time on debugging. As the quite sarcastic quote goes:
"6 hours of debugging can save you 5 minutes of reading documentation".
To improve the developer experience, we have moved the "Schema reference"-page to the top menu and improved the documentation even further.
You'll find the Schema reference right here.
Improvement Get help text throughout the app 🆘
Throughout the Enterspeed-app you'll encounter our help-icon (?). Here you'll find a short explanation of what the specific area/element is used for.
Hover your cursor over the icon to get a tooltip containing supporting text.
Improvement Autofilling schema alias ✍️
Nothing is more annoying than having to repeat things (every parent especially knows this feeling - "...for the 36. time, no! You can't have ice cream instead of dinner! God!").
To make your life a little bit easier (and save your precious mental energy for when your kids are being annoying) the schema alias now gets auto-filled.
If you want to rename your schema alias to something else, you simply click on the padlock icon.
Improvement Refresh button on source entity 🔄
If you're working on your data source (e.g. the CMS you've connected) simultaneously while viewing the specific data in Enterspeed, you may need to refresh this view.
Instead of refreshing the browser, you can now simply click on the refresh button which refreshes the source entity.
Improvement Added test button on source entity single view (pane view) 🧪
When designing your schema, it can be really helpful having your source entity next to you. This is why we have the "Source entities"-pane available directly in the schema editor.
Here you are also able to test your schema with a specific source entity.
Before this could only be done via the table view, listing all source entities. Now the test button is also available in the "source entity single view", meaning you won't have to navigate back and forth.
fixFixes and tweaks 🛠️
- New and improved onboarding experience when creating an account.
- Added "environment client" and "domains" to the getting started checklist.
- The top property in $lookup now supports both number and string format.
- Schema alias is now visible in the schema editor.
- Creating a schema now automatically redirects you to the schema afterward.