Public Product Endpoints

Retrieve a collection of Products via get

get

Authorizations

bearer_auth

AuthorizationstringRequired

Enter JWT Bearer token in the format: Bearer {your-token}

Query parameters

pageinteger · min: 1 · nullableOptional

Page of the index to retrieve

Example: 1

per_pageinteger · min: 1 · max: 100 · nullableOptional

Number of Products per page to retrieve for the index

Example: 20

search_termsstring[] · nullableOptional

Array of search terms for filtering the Products to retrieve in the index

Example: test

tag_filtersstring[] · nullableOptional

Array of tags to filter the Products to retrieve in the index

Example: LTI11

Responses

200

get success: Product Collection

application/json

401

Unauthorized

get

/api/public/v1/products

HTTPcURLJavaScriptPython

GET /learnplatform/public-products/api/public/v1/products HTTP/1.1
Host: api-gateway.instructure.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "products": [
    {
      "id": 1777,
      "name": "Name 1",
      "tagline": "Name 2",
      "url": "kassulke-hansen.test/luise_will",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1706,
        "name": "string-12",
        "company_url": "http://site-3.test"
      },
      "company_name": "string-12",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    },
    {
      "id": 1778,
      "name": "Name 4",
      "tagline": "Name 5",
      "url": "sauer-mosciski.example/verline.johnson",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1706,
        "name": "string-12",
        "company_url": "http://site-3.test"
      },
      "company_name": "string-12",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    },
    {
      "id": 1779,
      "name": "Name 7",
      "tagline": "Name 8",
      "url": "howe.example/antonia",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1706,
        "name": "string-12",
        "company_url": "http://site-3.test"
      },
      "company_name": "string-12",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    },
    {
      "id": 1780,
      "name": "Name 10",
      "tagline": "Name 11",
      "url": "dubuque.example/modesta.schamberger",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1706,
        "name": "string-12",
        "company_url": "http://site-3.test"
      },
      "company_name": "string-12",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    },
    {
      "id": 1781,
      "name": "Name 13",
      "tagline": "Name 14",
      "url": "yost.test/clyde_bruen",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1706,
        "name": "string-12",
        "company_url": "http://site-3.test"
      },
      "company_name": "string-12",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    }
  ],
  "meta": {
    "count": 5,
    "total_count": 5,
    "current_page": 1,
    "num_pages": 1,
    "per_page": 20
  }
}

Retrieve a collection of Products via post

post

Authorizations

bearer_auth

AuthorizationstringRequired

Enter JWT Bearer token in the format: Bearer {your-token}

Query parameters

pageinteger · min: 1 · nullableOptional

Page of the index to retrieve

Example: 1

per_pageinteger · min: 1 · max: 100 · nullableOptional

Number of Products per page to retrieve for the index

Example: 20

search_termsstring[] · nullableOptional

Array of search terms for filtering the Products to retrieve in the index

Example: test

tag_filtersstring[] · nullableOptional

Array of tags to filter the Products to retrieve in the index

Example: LTI11

Responses

200

post success: Product Collection

application/json

401

Unauthorized

post

/api/public/v1/products

HTTPcURLJavaScriptPython

POST /learnplatform/public-products/api/public/v1/products HTTP/1.1
Host: api-gateway.instructure.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "products": [
    {
      "id": 1787,
      "name": "Name 31",
      "tagline": "Name 32",
      "url": "larson.test/kristian",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1708,
        "name": "string-60",
        "company_url": "http://site-9.test"
      },
      "company_name": "string-60",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    },
    {
      "id": 1788,
      "name": "Name 34",
      "tagline": "Name 35",
      "url": "beer.example/luke",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1708,
        "name": "string-60",
        "company_url": "http://site-9.test"
      },
      "company_name": "string-60",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    },
    {
      "id": 1789,
      "name": "Name 37",
      "tagline": "Name 38",
      "url": "glover.example/athena",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1708,
        "name": "string-60",
        "company_url": "http://site-9.test"
      },
      "company_name": "string-60",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    },
    {
      "id": 1790,
      "name": "Name 40",
      "tagline": "Name 41",
      "url": "langosh.test/tommy",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1708,
        "name": "string-60",
        "company_url": "http://site-9.test"
      },
      "company_name": "string-60",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    },
    {
      "id": 1791,
      "name": "Name 43",
      "tagline": "Name 44",
      "url": "sanford-gutmann.example/elinore.rowe",
      "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
      "company": {
        "id": 1708,
        "name": "string-60",
        "company_url": "http://site-9.test"
      },
      "company_name": "string-60",
      "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png"
    }
  ],
  "meta": {
    "count": 5,
    "total_count": 5,
    "current_page": 1,
    "num_pages": 1,
    "per_page": 20
  }
}

Returns details for a Product

get

Authorizations

bearer_auth

AuthorizationstringRequired

Enter JWT Bearer token in the format: Bearer {your-token}

Path parameters

idinteger · min: 1Required

ID of the Product to retrieve

Example: 1

Responses

200

Details for the Product

application/json

idintegerRequired

ID of the Product

namestringRequired

Name of the Product

descriptionstring · nullableOptional

Description of the Product

taglinestring · nullableOptional

Tagline of the Product

urlstring · nullableOptional

Primary URL for the Product information

logo_image_urlstring · nullableOptional

URL of the Product logo image

logo_urlstring · nullableOptional

URL of the Product logo image

company_namestring · nullableOptional

Name of the company that created the Product

company_urlstring · nullableOptional

URL of the company that created the Product

screenshot_image_urlsstring[] · nullableOptional

list of image URLs of the Product screenshots

banner_image_urlstring · nullableOptional

URL of the Product card image

support_urlstring · nullableOptional

URL for support of the Product

accessibility_urlstring · nullableOptional

URL describing the accessibility of the Product

privacy_policy_urlstring · nullableOptional

URL describing the privacy policy of the Product

terms_of_service_urlstring · nullableOptional

URL describing the terms of service of the Product

accepting_leadsboolean · nullableOptional

Whether the Product is accepting leads

videostring · nullableOptional

Video of the Product

401

Unauthorized

404

Product not found

get

/api/public/v1/products/{id}

HTTPcURLJavaScriptPython

GET /learnplatform/public-products/api/public/v1/products/{id} HTTP/1.1
Host: api-gateway.instructure.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1797,
  "name": "Name 61",
  "description": "Name 63",
  "tagline": "Name 62",
  "url": "halvorson.example/mariano",
  "logo_url": "https://assets.learnplatform.com/assets/cat_badge.png",
  "logo_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
  "company": {
    "id": 1710,
    "name": "string-110",
    "company_url": "http://site-15.test"
  },
  "company_name": "string-110",
  "company_url": "http://site-15.test",
  "screenshot_image_urls": [
    "https://assets.learnplatform.com/assets/screenshot.png",
    "https://assets.learnplatform.com/assets/screenshot.png",
    "https://assets.learnplatform.com/assets/screenshot.png"
  ],
  "banner_image_url": "https://assets.learnplatform.com/assets/cat_badge.png",
  "support_url": null,
  "accessibility_url": "http://fadel-grimes.example/luis",
  "privacy_policy_url": "http://rice.example/senaida",
  "terms_of_service_url": "http://wolf.test/tamiko.prohaska",
  "badges": [],
  "lti_configurations": {
    "lti_13": {
      "services": [
        "est"
      ],
      "placements": [
        "sit"
      ]
    }
  },
  "accepting_leads": false,
  "video": "http://tremblay.example/novella"
}

Save details of user for learn more

post

Body

application/json

countrystringRequiredExample: US

statestringRequiredExample: AR

organizationstringRequiredExample: Lawrence Public School District

current_canvas_companyboolean · nullableOptionalExample: true

gradestring · enum · nullableOptionalExample: K12Possible values:

namestringRequiredExample: Anne Example

rolestringRequiredExample: C&I Director

emailstring · emailRequiredExample: [email protected]

notesstring · nullableOptionalExample: Please detail any specific information you would like to learn from this partner.

tool_idintegerRequiredExample: 123

Responses

201

post success: User details saved when state is empty

application/json

422

Not accepting leads: Unprocessable Entity

application/json

post

/api/public/v1/learn_more

HTTPcURLJavaScriptPython

POST /learnplatform/public-products/api/public/v1/learn_more HTTP/1.1
Host: api-gateway.instructure.com
Content-Type: application/json
Accept: */*
Content-Length: 304

{
  "country": "US",
  "state": "AR",
  "organization": "Lawrence Public School District",
  "current_canvas_company": true,
  "grade": "K12",
  "name": "Anne Example",
  "role": "C&I Director",
  "email": "[email protected]",
  "notes": "Please detail any specific information you would like to learn from this partner.",
  "tool_id": 123
}

{
  "message": "Thank you for your interest in learning more about Sample Tool Name!"
}