Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions umbraco-heartcore/.gitbook.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,5 @@ root: ./
readme: README.md
summary: SUMMARY.md

redirects:
api-documentation/redirect: api-documentation/content-delivery/redirect.md
4 changes: 3 additions & 1 deletion umbraco-heartcore/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,10 +24,10 @@

* [API Documentation](api-documentation/README.md)
* [Rate Limits](api-documentation/rate-limits.md)
* [Redirect API](api-documentation/redirect.md)
* [Content Delivery](api-documentation/content-delivery/README.md)
* [Content](api-documentation/content-delivery/content.md)
* [Media](api-documentation/content-delivery/media.md)
* [Redirect API](api-documentation/content-delivery/redirect.md)
* [Content Management](api-documentation/content-management/README.md)
* [Umbraco Forms](api-documentation/content-management/forms.md)
* [Languages](api-documentation/content-management/language.md)
Expand Down Expand Up @@ -68,3 +68,5 @@

* [February 2024](release-notes/2024-02-releasenotes.md)
* [April 2024](release-notes/2024-04-releasenotes.md)
* [August 2024](release-notes/2024-08-releasenotes.md)
* [September 2024](release-notes/2024-09-releasenotes.md)
2 changes: 0 additions & 2 deletions umbraco-heartcore/api-documentation/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,6 @@ This page contains documentation for the available API endpoints for Umbraco Hea

[The Content Management API](content-management/README.md) can be used to Create, Read, Update and Delete Content, Media, Languages, Relations, Members, and the associated types using Umbraco Backoffice user credentials or API Keys. The API is available on `https://api.umbraco.io`.

[The Redirect API](redirect.md) can be used to query redirects setup in the Umbraco backoffice when moving or renaming content. Use it to create Redirect maps for your website, app, etc. The API is available on `https://cdn.umbraco.io/redirect`.

The Preview API is the read-only Content and Media that you would retrieve to show the draft content in your apps, websites, or other platforms. The API is available on `https://preview.umbraco.io`. The Preview API is always protected and requires an `Api-Key`. The endpoints are the same as the Content Delivery API.

## REST API Standard
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,6 @@

This is the read-only API for delivering redirects, caused by moving or renaming content in the Umbraco backoffice, to any app, website, device, or platform.

{% hint style="info" %}
The redirect API is only available if your project is using the **Content Delivery Platform**. You can verify this in the Umbraco backoffice, settings section in the headless overview panel.
{% endhint %}

## Cultures

To request redirects in a specific language, a culture parameter can be specified. When no culture is specified it's treated as invariant and the default language will be returned.
Expand Down Expand Up @@ -55,7 +51,7 @@ If an error occurs, you will receive a HTTP status code along with an API error

## Get all redirects

Gets all redirect URLs.
Get all redirect URLs.

The key is the URL of the content and the values are the URLs redirecting to the content.

Expand Down Expand Up @@ -107,3 +103,28 @@ The maximum page size is 1000.
}
}
```


## Get content by redirect URL

Get the destination URL and redirect URLs for a given path.

**URL**: `/redirect/redirecturl?url={url}`

**Method**: `GET`

### Success Response

**Code**: 200

**Content Example**:

```json
{
"url": "/home",
"redirectUrls": [
"/home-redirect-example-1",
"/home-redirect-example-2"
]
}
```
2 changes: 1 addition & 1 deletion umbraco-heartcore/release-notes/2024-02-releasenotes.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# February 2024
The following features are available to new sites created on or after February 12th. They will be rolled out to existing sites in the second quarter of 2024.
The following changes have been released to all Heartcore sites.

## Block Grid Editor
The Block Grid Editor from core Umbraco is now available in Heartcore. A modern alternative to the Grid Editor, this type is particularly useful for allowing content authors to build page-like structures.
Expand Down
2 changes: 1 addition & 1 deletion umbraco-heartcore/release-notes/2024-04-releasenotes.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# April 2024
The following changes have been released to Heartcore sites created on or after February 12th. They will be rolled out to previously existing sites in the second quarter of 2024.
The following changes have been released to all Heartcore sites.

## Grid Disabled By Default
With the grid property editor [becoming deprecated](https://umbraco.com/blog/umbraco-heartcore-update-october-2023/), it has been decided to hide related functionality in the backoffice for sites that are not using it yet. The modern alternative to Grid Editor is the Block Grid Editor. The migration between Grid and Block Grid won't be fully automated, so this decision was made to encourage use of the most future-proof Data Type.
Expand Down
14 changes: 14 additions & 0 deletions umbraco-heartcore/release-notes/2024-08-releasenotes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# August 2024
The following changes have been released to all Heartcore sites.

## Webhook Enhancements
With the core CMS adding webhook support, the same functionality has been adapted into Heartcore to use the same user interface. You will now get the same consistent editing experience in both Umbraco CMS and Umbraco Heartcore, and it also comes with new features.
* You may now select multiple event types (for example, publish / unpublish) or content types for a webhook. No more needing to create dozens of hooks to achieve what can now be done with only one.
* You may now specify custom HTTP headers to send to your endpoint whenever the webhook fires.

Aside from the interface, all other aspects of webhooks in Heartcore are unchanged. Webhooks are still fired from the delivery platform with the same IP address range, retry policy, and payload that you are used to.

For more information about webhook functionality, both new and old, check out the [updated Webhooks article](../getting-started/webhooks.md).

## Improved Firewall
A recent roll-out has added additional firewall rules for all Heartcore services. While efforts have been made to tune these, there is always a small possibility of false positives. If you believe your legitimate traffic is affected, please raise a support ticket through the portal.
7 changes: 7 additions & 0 deletions umbraco-heartcore/release-notes/2024-09-releasenotes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# September 2024
The following changes have been released to all Heartcore sites.

## New Redirect Endpoint
For a long time, the only way to get redirect information from Heartcore was a single endpoint on the Delivery API. This endpoint returned paginated redirect information for _all_ content items in the tree. If you needed to find the canonical URL for a given path, then this endpoint was your only option. You would need to find your path in the returned items - especially challenging if it was not on the first page of results!

In order to save you the trouble, a brand new endpoint has been added to the Delivery API. It allows you to fetch the canonical URL (and any other redirects) for a given path. For more information, check out the [updated Redirect article](../api-documentation/content-delivery/redirect.md#get-content-by-redirect-url).