Tapslash

The Tapslash Developer Hub

Welcome to the Tapslash developer hub. Here you'll find comprehensive guides and documentation to help you start working with the SDK(s) as quickly as possible, as well as support if you get stuck slong the way. Let's jump right in!

Get Started    

Metadata Endpoint

Parse links

Parse links

Use Case

Result objects are queried from our search endpoint and are then used to render result cards.

The metadata endpoint is useful if you don't want to pass along entire result objects through your messaging infrastructure.

Instead, you transfer only the result url, and on the recipient you parse out that url and query the metadata separately. This strategy has the added benefit of being more compatible with existing messaging clients. Clients who have not yet implemented our SDK simply receive a url in their regular message format.

Endpoint

Receives a url and returns back metadata if present.

Only urls found via our search endpoint are valid.

Endpoint: https://metadata.tapslash.com/
Scheme: https (does not support http)
Method: POST
Content-Type: application/json

{
	"url": "string"
}
curl \
--request POST \
--url "https://metadata.tapslash.com" \
--data "{\"url\":\"https://itunes.apple.com/us/album/everything-i-am-feat.-dj-premier/id401264138?i=401264208&uo=4\"}"
{
  "subtitle": "Kanye West & DJ Premier",
  "uid": "",
  "service": "music",
  "title": "Everything I Am (feat. DJ Premier)",
  "url": "https://itunes.apple.com/us/album/everything-i-am-feat.-dj-  premier/id401264138?i=401264208&uo=4",
  "slash-short": "http://tapsla.sh/rsD1flP",
  "image": {
    "url": "http://is3.mzstatic.com/image/thumb/Music/v4/63/21/74/6321742c-7a33- 06e3-76ef-2a85659844eb/source/100x100bb.jpg",
    "width": "512",
    "height": "512",
    "size": ""
  },
  "detail": {
    "duration": "3:47",
    "album": "Graduation"
  },
  "display_type": "default",
  "output": "Everything I Am (feat. DJ Premier)\nKanye West & DJ Premier\nhttp://tapsla.sh/rsD1flP"
}

If the metadata is not found, the endpoint will return with status code 404 and a json error message:

{
  "error": "ItemNotFound: url='www.google.com'"
}

Metadata Endpoint