integration : Foxy hAPI

integrations

Description

This link relationship returns a collection of resources. You can easily paginate through this collection using the hypermedia links provided and the link relationships of first, prev, next, and last. Scroll down to view a representation of a single resource embedded within this collection.

Interact with this resource

To interact with this resource and see it in the context of the API, you can utilise Postman or your Terminal/Console to perform requests. If you have a Foxy store, you can also use the API browser in the admin to interact with resources connected to your store.

Actions

GET: View a list of integrations
POST: Create an integration
HEAD: Get just the header response
OPTIONS: Get a response explaining which HTTP methods are supported

If you'd like to add an access token for working with our Hypermedia API, make POST request with a project_name(required) and project_description. All users with access to this store will be able to view and/or remove this integration entry. Other values will be automatically generated for you. After creation you will get client_id, client_secret, access_token, refresh_token.

Example Representation

{
  "_links": {
    "curies": [
      {
        "name": "fx",
        "href": "https://api.foxycart.com/rels/{rel}",
        "templated": true
      }
    ],
    "self": {
      "href": "...",
      "title": "This Collection"
    },
    "first": {
      "href": "...?offset=0",
      "title": "First Page of this Collection"
    },
    "prev": {
      "href": "...?offset=0",
      "title": "Previous Page of this Collection"
    },
    "next": {
      "href": "...?offset=0",
      "title": "Next Page of this Collection"
    },
    "last": {
      "href": "...?offset=0",
      "title": "Last Page of this Collection"
    }
  },
  "_embedded": {
    "fx:integrations": [...]
  },
  "total_items": "5",
  "returned_items": 5,
  "limit": 20,
  "offset": 0
}

<?xml version="1.0" encoding="UTF-8"?>
<resource href="...">
  <link rel="self" href="..." title="This Collection"/>
  <link rel="first" href="...?offset=0" title="First Page of this Collection"/>
  <link rel="prev" href="...?offset=0" title="Previous Page of this Collection"/>
  <link rel="next" href="...?offset=0" title="Next Page of this Collection"/>
  <link rel="last" href="...?offset=0" title="Last Page of this Collection"/>
  <resource href="..." rel="https://api.foxycart.com/rels/integration">
  ...
  </resource>
  <total_items>5</total_items>
  <returned_items>5</returned_items>
  <limit>20</limit>
  <offset>0</offset>
</resource>

{
    "properties": {
        "total_items": "5",
        "returned_items": 5,
        "limit": 20,
        "offset": 0
    },
    "entities": [...],
    "links": [
        {
            "rel": [
                "self"
            ],
            "href": "..."
        },
        {
            "rel": [
                "first"
            ],
            "href": "...?offset=0"
        },
        {
            "rel": [
                "prev"
            ],
            "href": "...?offset=0"
        },
        {
            "rel": [
                "next"
            ],
            "href": "...?offset=0"
        },
        {
            "rel": [
                "last"
            ],
            "href": "...?offset=0"
        }
    ],
    "actions": [
    ]
}

Embedded Resource: integration

Description

An integration represents an active OAuth refresh token with the current store. Each OAuth integration that has been activated and approved for the current store will be represented as an integration. Integrations can be deleted which will delete the refresh token from our system.

When deleting an integration, you will also be deleting any access tokens with the same client_id, user_uri, and scope. Warning: If you delete the integration your API client is currently using, you will have to re-authenticate your client via the OAuth Code Grant process.

Interact with this resource

Actions

GET: View an integration
DELETE: Delete an integration
HEAD: Get just the header response
OPTIONS: Get a response explaining which HTTP methods are supported

Properties

Property	Description	Type	Constraints
user_uri	A full API URI of the user resource used in this relationship. When working with hypermedia, it's important to save URIs and not just numeric ids.	URI	Read only
client_id	A unique identifier for this client. Maps to the client_id of the client resource.	String	Read only
scope	The OAuth scope granted to this integration.	String	Read only
expires	When this OAuth refresh token expires.	Timestamp	Read only
project_name	Maps to the project_name of the client resource.	String	Read only
project_description	Maps to the project_description of the client resource.	String	Read only
company_name	Maps to the company_name of the client resource.	String	Read only
company_url	Maps to the company_url of the client resource.	URL	Read only
company_logo	Maps to the company_logo of the client resource.	URL	Read only
contact_name	Maps to the contact_name of the client resource.	String	Read only
contact_email	Maps to the contact_email of the client resource.	String	Read only
added_by_name	Maps to the first_name and last_name of the user resource.	String	Read only
added_by_email	Maps to the email of the user resource.	Email	Read only

Example Representation

{
    "_links": {
        "curies": [
            {
                "name": "fx",
                "href": "https://api.foxycart.com/rels/{rel}",
                "templated": true
            }
        ],
        "self": {
            "href": "https://api.foxycart.com/integrations/ae1beea4f8cbc26989a874dec8d9198216555ba6e153545a15641edfe52325aa232ae290c267c92d6a80da9817ed81bb",
            "title": "This OAuth Integration"
        },
        "fx:store": {
            "href": "https://api.foxycart.com/stores/66",
            "title": "This Store"
        },
        "fx:user": {
            "href": "https://api.foxycart.com/users/92",
            "title": "This User"
        },
        "fx:client": {
            "href": "https://api.foxycart.com/clients/2",
            "title": "This Client"
        }
    },
    "user_uri": "https://api.foxycart.com/users/92",
    "client_id": "super_duper_client_id",
    "scope": "user_full_access store_full_access store_id_66",
    "expires": 1752787287,
    "project_name": "My Super Project",
    "project_description": "A really cool project you should be excited about.",
    "company_name": "FoxyCart",
    "company_url": "http://www.foxycart.com",
    "company_logo": "http://www.foxycart.com/assets/templates/v02/slices/foxycart-seo-ecommerce.png",
    "contact_name": "Mr. Example",
    "contact_email": "example@example.com",
    "added_by_name": "First Last",
    "added_by_email": "someone@example.com"
}

<?xml version="1.0" encoding="UTF-8"?>
<resource href="https://api.foxycart.com/integrations/ae1beea4f8cbc26989a874dec8d9198216555ba6e153545a15641edfe52325aa232ae290c267c92d6a80da9817ed81bb" rel="https://api.foxycart.com/rels/integration">
  <link rel="self" href="https://api.foxycart.com/integrations/ae1beea4f8cbc26989a874dec8d9198216555ba6e153545a15641edfe52325aa232ae290c267c92d6a80da9817ed81bb" title="This OAuth Integration"/>
  <link rel="https://api.foxycart.com/rels/store" href="https://api.foxycart.com/stores/66" title="This Store"/>
  <link rel="https://api.foxycart.com/rels/user" href="https://api.foxycart.com/users/92" title="This User"/>
  <link rel="https://api.foxycart.com/rels/client" href="https://api.foxycart.com/clients/2" title="This Client"/>
  <user_uri>https://api.foxycart.com/users/92</user_uri>
  <client_id>super_duper_client_id</client_id>
  <scope>user_full_access store_full_access store_id_66</scope>
  <expires>1752787287</expires>
  <project_name>My Super Project</project_name>
  <project_description>A really cool project you should be excited about.</project_description>
  <company_name>FoxyCart</company_name>
  <company_url>http://www.foxycart.com</company_url>
  <company_logo>http://www.foxycart.com/assets/templates/v02/slices/foxycart-seo-ecommerce.png</company_logo>
  <contact_name>Mr. Example</contact_name>
  <contact_email>example@example.com</contact_email>
  <added_by_name>First Last</added_by_name>
  <added_by_email>someone@example.com</added_by_email>
</resource>

{
    "class": [
        "integration"
    ],
    "properties": {
        "user_uri": "https://api.foxycart.com/users/92",
        "client_id": "super_duper_client_id",
        "scope": "user_full_access store_full_access store_id_66",
        "expires": 1752787287,
        "project_name": "My Super Project",
        "project_description": "A really cool project you should be excited about.",
        "company_name": "FoxyCart",
        "company_url": "http://www.foxycart.com",
        "company_logo": "http://www.foxycart.com/assets/templates/v02/slices/foxycart-seo-ecommerce.png",
        "contact_name": "Mr. Example",
        "contact_email": "example@example.com",
        "added_by_name": "First Last",
        "added_by_email": "someone@example.com"
    },
    "links": [
        {
            "rel": [
                "self"
            ],
            "href": "https://api.foxycart.com/integrations/ae1beea4f8cbc26989a874dec8d9198216555ba6e153545a15641edfe52325aa232ae290c267c92d6a80da9817ed81bb"
        },
        {
            "rel": [
                "https://api.foxycart.com/rels/store"
            ],
            "href": "https://api.foxycart.com/stores/66"
        },
        {
            "rel": [
                "https://api.foxycart.com/rels/user"
            ],
            "href": "https://api.foxycart.com/users/92"
        },
        {
            "rel": [
                "https://api.foxycart.com/rels/client"
            ],
            "href": "https://api.foxycart.com/clients/2"
        }
    ],
    "actions": [
    ]
}

Zoomable Resources

This resource has no linked resources which can be "zoomed" in on, filtered and embedded within this resource.