Partnerships v1

GET /partnerships

Returns the list of validated partnerships. This is the recommended way to render your partner's logos.

Request

app.js
import axios from 'axios'

const result = await axios.get('https://api.sliko.io/v1/partnerships',
  {
    headers: {
      apiKey: <YOUR_API_KEY>
    },
  }); 

curl -i -H "apiKey: <YOUR_API_KEY>" -H "Accept: application/json" -H "Content-Type: application/json" https://api.sliko.io/v1/partnerships

Optional query params

You are able to paginate your requests (for better performance) using offset and limit, you are also able to request the version of your parnter's logo with a specific format and color.

Query param offset

Specifies the number of items the API should skip/offset, useful for pagination (won't affect the total_count).

Query param limit

Specifies the amount/limit of partnerships returned (won't affect the total_count).

Query param color:

  • brand returns the logo with its brand colors
  • monochromatic returns the logo in SVG format which can be manipulated by the consumer to have the desired fill color

Query param format:

  • square returns the logo in a 1x1 ratio.
  • horizontal returns the logo in a 2.5:1 ratio.

Default values are: offset 0, limit 20, color brand and format horizontal

// Example requesting the partnerships with its partner's logo:
// - color: monochromatic 
// - format: square 

https://api.sliko.io/v1/partnerships?color=monochromatic&format=square

Response

{
  "partnerships": [
    {
      "logo_url": "string",
      "company_name": "string",
      "partnership_url": "string"
    }
  ],
  "total_count": 0,
  "new_partnership_url": "string"
}

For each partnership, link back to the Sliko platform by allowing visitors to be reedirect to the partnership_url. This is where the details about the partnership (along with validation) are displayed.

new_partnership_url

A direct link to request a new partnership with your company.

total_count

The total number of validated partnerships.

Useful for social proof, for example:

We're currently helping ${total_count} business grow their audience.

200:

{
  "partnerships": [
    {
      "logo_url": "https://sliko-dev3.s3.eu-central-1.wasabisys.com/companies/5392dadf-2d86-4615-8333-56386a89cfdf/logo?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XLZOICAJDLNX1VO6QKKA%2F20210703%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20210703T094951Z&X-Amz-Expires=1200&X-Amz-Signature=c8ca934a465d34238a56f3627cc0895f7debe0bdc3a9c3ceda88c33c2a9aa015&X-Amz-SignedHeaders=host",
      "company_name": "LEY",
      "partnership_url": "https://sliko.io/partnerships/1ad967be-a258-4368-bab9-d15e9503bfda"
    },
    {
      "logo_url": "https://sliko-dev3.s3.eu-central-1.wasabisys.com/companies/c28ec340-47c7-4d05-9dc5-37740baa7e36/logo?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XLZOICAJDLNX1VO6QKKA%2F20210703%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20210703T094951Z&X-Amz-Expires=1200&X-Amz-Signature=008d6babedf0f3982a2057dbcd4fe8767fe649529d1aec99d951f1f415521917&X-Amz-SignedHeaders=host",
      "company_name": "Slack",
      "partnership_url": "https://sliko.io/partnerships/25ba430f-67cc-4546-a146-344efccd1cdc"
    },
    {
      "logo_url": "https://sliko-dev3.s3.eu-central-1.wasabisys.com/companies/dc03be5a-0d78-4146-b16e-d8c0a8a550d0/logo?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XLZOICAJDLNX1VO6QKKA%2F20210703%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20210703T094951Z&X-Amz-Expires=1200&X-Amz-Signature=d480b41d7b249d4f071bb68e6367e2874c8d5c65d71749acdc4b4b8bd0d62d8d&X-Amz-SignedHeaders=host",
      "company_name": "Google",
      "partnership_url": "https://sliko.io/partnerships/7c11faab-3ffd-495b-b059-3ce6193f1c5e"
    },
  ],
  "total_count": 8,
  "new_partnership_url": "https://sliko.io/partnerships/new?partner=sliko"
}

GET /partnerships/logos

Returns the list of your partner's logos for validated partnerships.

Request

app.js
import axios from 'axios'

const result = await axios.get('https://api.sliko.io/v1/partnerships/logos',
  {
    headers: {
      apiKey: <YOUR_API_KEY>
    },
  }); 

curl -i -H "apiKey: <YOUR_API_KEY>" -H "Accept: application/json" -H "Content-Type: application/json" https://api.sliko.io/v1/partnerships/logos

Optional query param limit

Specifies the amount/limit of partnership logos returned.

https://api.sliko.io/v1/partnerships/logos?limit=10

Response

[
  "string"
]

200:

[
  "https://sliko-dev3.s3.eu-central-1.wasabisys.com/companies/5392dadf-2d86-4615-8333-56386a89cfdf/logo?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XLZOICAJDLNX1VO6QKKA%2F20210703%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20210703T100628Z&X-Amz-Expires=1200&X-Amz-Signature=ddd7ba6bc0b9f38bdaaaf53f01a255f1d715233862e7b77b1ba3d2ce60fc4d46&X-Amz-SignedHeaders=host",
  "https://sliko-dev3.s3.eu-central-1.wasabisys.com/companies/c28ec340-47c7-4d05-9dc5-37740baa7e36/logo?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XLZOICAJDLNX1VO6QKKA%2F20210703%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20210703T100628Z&X-Amz-Expires=1200&X-Amz-Signature=084cb4b99cca376139a9c413942d492e7f39df8cf438383b75dcdaf56380b105&X-Amz-SignedHeaders=host",
  "https://sliko-dev3.s3.eu-central-1.wasabisys.com/companies/f072d262-79c4-4216-a2ea-f6e38718592a/logo?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XLZOICAJDLNX1VO6QKKA%2F20210703%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20210703T100628Z&X-Amz-Expires=1200&X-Amz-Signature=b95b69ec84e010ac00245200cf51dd6e6c4a0edc4e5f087b958b52b7512003b3&X-Amz-SignedHeaders=host"
]
Edit this page on GitHub Updated at Mon, Dec 13, 2021
Logo Team