Storyden
Links

Link Create

Add a link to the community bookmarks. This will also scrape the content at the site the link points to, if possible. If the submitted link is an invalid link for whatever reason (invalid URL structure or page is dead) then the API will fail. The metadata for the link is indexed on success. If the submitted link already exists it will be an idempotent operation, unless the body contains additional metadata. In these cases, the link's metadata will be updated with the new metadata and the URL is unchanged. When a link is submitted, it is first "cleaned" to remove any fragments.

Add a link to the community bookmarks. This will also scrape the content at the site the link points to, if possible. If the submitted link is an invalid link for whatever reason (invalid URL structure or page is dead) then the API will fail. The metadata for the link is indexed on success.

If the submitted link already exists it will be an idempotent operation, unless the body contains additional metadata. In these cases, the link's metadata will be updated with the new metadata and the URL is unchanged.

When a link is submitted, it is first "cleaned" to remove any fragments.

POST/links

Authorization

storyden-session<token>

In: cookie

Request Body

urlURL

A web address

Formaturl
title?LinkTitle
description?LinkDescription

Response Body

curl -X POST "https://loading/api/links" \  -H "Content-Type: application/json" \  -d '{    "url": "string"  }'
{
  "id": "cc5lnd2s1s4652adtu50",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "deletedAt": "2019-08-24T14:15:22Z",
  "misc": {},
  "url": "string",
  "slug": "github-com-southclaws-storyden",
  "domain": "github.com",
  "title": "The Open Graph Protocol",
  "description": "The Open Graph protocol enables any web page to become a rich object in a social graph.",
  "favicon_image": {
    "id": "cc5lnd2s1s4652adtu50",
    "filename": "string",
    "path": "string",
    "mime_type": "string",
    "width": 0,
    "height": 0,
    "parent": {
      "id": "cc5lnd2s1s4652adtu50",
      "filename": "string",
      "path": "string",
      "mime_type": "string",
      "width": 0,
      "height": 0,
      "parent": {}
    }
  },
  "primary_image": {
    "id": "cc5lnd2s1s4652adtu50",
    "filename": "string",
    "path": "string",
    "mime_type": "string",
    "width": 0,
    "height": 0,
    "parent": {
      "id": "cc5lnd2s1s4652adtu50",
      "filename": "string",
      "path": "string",
      "mime_type": "string",
      "width": 0,
      "height": 0,
      "parent": {}
    }
  }
}
Empty
{
  "error": "string",
  "message": "string",
  "suggested": "string",
  "metadata": {}
}
Edit on GitHub

Node Update Visibility PATCH PATCH

Update the visibility of a node. When changed, this may trigger other operations such as notifications/newsletters. Changing the visibility of anything to "published" is often accompanied by some other side effects.

Link Get GET GET

Get the details for a specific link. Such as where it's been posted, which resources it's linked to and how many times it's been opened.