Shopify Admin API
  1. Shop
Shopify Admin API
  • Customers
    • Customer Address
      • Retrieves a list of addresses for a customer
      • Creates a new address for a customer
      • Retrieves details for a single customer address
      • Updates an existing customer address
      • Removes an address from a customer’s address list
      • Performs bulk operations for multiple customer addresses
      • Sets the default address for a customer
    • CustomerSavedSearch
      • Retrieves a list of customer saved searches
      • Creates a customer saved search
      • Retrieves a count of all customer saved searches
      • Retrieves a single customer saved search
      • Updates a customer saved search
      • Deletes a customer saved search
      • Retrieves all customers returned by a customer saved search
    • Customer
      • Retrieves a list of customers
      • Creates a customer
      • Searches for customers that match a supplied query
      • Retrieves a single customer
      • Updates a customer
      • Deletes a customer
      • Creates an account activation URL for a customer
      • Sends an account invite to a customer
      • Retrieves a count of customers
      • Retrieves all orders that belong to a customer
  • Sales channels
    • Checkout
      • Creates a checkout
      • Completes a checkout
      • Retrieves a checkout
      • Modifies an existing checkout
      • Retrieves a list of shipping rates
    • CollectionListing
      • Retrieve collection listings that are published to your app
      • Retrieve product_ids that are published to a collection_id
      • Retrieve a specific collection listing that is published to your app
      • Create a collection listing to publish a collection to your app
      • Delete a collection listing to unpublish a collection from your app
    • Product ResourceFeedback
      • Create a new Product ResourceFeedback
      • Receive a list of all Product ResourceFeedbacks
    • MobilePlatformApplication
      • List all of the mobile platform applications associated with the app
      • Create a mobile platform application
      • Get a mobile platform application
      • Update a mobile platform application
      • Delete a mobile platform application
    • ProductListing
      • Retrieve product listings that are published to your app
      • Retrieve product_ids that are published to your app
      • Retrieve a count of products that are published to your app
      • Retrieve a specific product listing that is published to your app
      • Create a product listing to publish a product to your app
      • Delete a product listing to unpublish a product from your app
    • ResourceFeedback
      • Create a new ResourceFeedback
      • Receive a list of all ResourceFeedbacks
    • Payment
      • Creates a new payment
      • Retrieves a list of payments on a particular checkout
      • Retrieves a single payment
      • Counts the number of payments attempted on a checkout
  • Products
    • Collect
      • Adds a product to a custom collection
      • Retrieves a list of collects
      • Removes a product from a collection
      • Retrieves a specific collect by its ID
      • Retrieves a count of collects
    • Collection
      • Retrieves a single collection
      • Retrieve a list of products belonging to a collection
    • CustomCollection
      • Retrieves a list of custom collections
      • Creates a custom collection
      • Retrieves a count of custom collections
      • Retrieves a single custom collection
      • Updates an existing custom collection
      • Deletes a custom collection
    • Product
      • Retrieve a list of products
      • Create a new product
      • Retrieve a count of products
      • Retrieve a single product
      • Updates a product
      • Delete a product
    • Product Image
      • Receive a list of all Product Images
      • Create a new Product Image
      • Receive a count of all Product Images
      • Receive a single Product Image
      • Modify an existing Product Image
      • Remove an existing Product Image
    • Product Variant
      • Retrieves a list of product variants
      • Create a new Product Variant
      • Receive a count of all Product Variants
      • Receive a single Product Variant
      • Modify an existing Product Variant
      • Remove an existing Product Variant
    • SmartCollection
      • Retrieves a list of smart collections
      • Creates a smart collection
      • Retrieves a count of smart collections
      • Retrieves a single smart collection
      • Updates an existing smart collection
      • Removes a smart collection
      • Updates the ordering type of products in a smart collection
  • Orders
    • Abandoned checkouts
      • Retrieves a list of abandoned checkouts
    • DraftOrder
      • Create a new DraftOrder
      • Retrieves a list of draft orders
      • Modify an existing DraftOrder
      • Receive a single DraftOrder
      • Remove an existing DraftOrder
      • Receive a count of all DraftOrders
      • Send an invoice
      • Complete a draft order
    • Order Risk
      • Creates an order risk for an order
      • Retrieves a list of all order risks for an order
      • Retrieves a single order risk by its ID
      • Updates an order risk
      • Deletes an order risk for an order
    • Transaction
      • Retrieves a list of transactions
      • Creates a transaction for an order
      • Retrieves a count of an order's transactions
      • Retrieves a specific transaction
    • Order
      • Retrieve a list of orders
      • Create an order
      • Retrieve a specific order
      • Update an order
      • Delete an order
      • Retrieve an order count
      • Close an order
      • Re-open a closed order
      • Cancel an order
    • Refund
      • Retrieves a list of refunds for an order
      • Creates a refund
      • Retrieves a specific refund
      • Calculates a refund
  • Access
    • AccessScope
      • Get a list of access scopes
    • StorefrontAccessToken
      • Creates a new StorefrontAccessToken
      • Retrieves a list of storefront access tokens that have been issued
      • Deletes an existing storefront access token
  • Billing
    • ApplicationCredit
      • Creates an application credit
      • Retrieves all application credits
      • Retrieves a single application credit
    • ApplicationCharge
      • Creates an application charge
      • Retrieves a list of application charges
      • Retrieves an application charge
    • UsageCharge
      • Creates a usage charge
      • Retrieves a list of usage charges
      • Retrieves a single charge
    • RecurringApplicationCharge
      • Creates a recurring application charge
      • Retrieves a list of recurring application charges
      • Retrieves a single charge
      • Cancels a recurring application charge
      • Updates the capped amount of a recurring application charge
  • Online store
    • Asset
      • Retrieves a single asset for a theme
      • Creates or updates an asset for a theme
      • Deletes an asset from a theme
    • Blog
      • Retrieve a list of all blogs
      • Create a new Blog
      • Receive a count of all Blogs
      • Receive a single Blog
      • Modify an existing Blog
      • Remove an existing Blog
    • Article
      • Retrieves a list of all articles from a blog
      • Creates an article for a blog
      • Retrieves a count of all articles from a blog
      • Receive a single Article
      • Updates an article
      • Deletes an article
      • Retrieves a list of all article authors
      • Retrieves a list of all article tags
      • Retrieves a list of all article tags from a specific blog
    • Redirect
      • Retrieves a list of URL redirects
      • Creates a redirect
      • Retrieves a count of URL redirects
      • Retrieves a single redirect
      • Updates an existing redirect
      • Deletes a redirect
    • Comment
      • Retrieves a list of comments
      • Creates a comment for an article
      • Retrieves a count of comments
      • Retrieves a single comment by its ID
      • Updates a comment of an article
      • Marks a comment as spam
      • Marks a comment as not spam
      • Approves a comment
      • Removes a comment
      • Restores a previously removed comment
    • ScriptTag
      • Retrieves a list of all script tags
      • Creates a new script tag
      • Retrieves a count of all script tags
      • Retrieves a single script tag
      • Updates a script tag
      • Deletes a script tag
    • Page
      • Retrieves a list of pages
      • Creates a page
      • Retrieves a page count
      • Retrieves a single page by its ID
      • Updates a page
      • Deletes a page
    • Theme
      • Retrieves a list of themes
      • Creates a theme
      • Retrieves a single theme by its ID
      • Modify an existing Theme
      • Remove an existing Theme
  • Shipping and fulfillment
    • CancellationRequest
      • Sends a cancellation request
      • Accepts a cancellation request
      • Rejects a cancellation request
    • CarrierService
      • Create a new CarrierService
      • Receive a list of all CarrierServices
      • Modify an existing CarrierService
      • Receive a single CarrierService
      • Remove an existing CarrierService
    • AssignedFulfillmentOrder
      • Retrieves a list of fulfillment orders on a shop for a specific app
    • FulfillmentEvent
      • Retrieves a list of fulfillment events for a specific fulfillment
      • Creates a fulfillment event
      • Retrieves a specific fulfillment event
      • Deletes a fulfillment event
    • Fulfillment
      • Retrieves fulfillments associated with an order
      • Retrieves fulfillments associated with a fulfillment order
      • Retrieves a count of fulfillments associated with a specific order
      • Receive a single Fulfillment
      • Creates a fulfillment for one or many fulfillment orders
      • Updates the tracking information for a fulfillment
      • Cancels a fulfillment
    • FulfillmentOrder
      • Retrieves a list of fulfillment orders for a specific order
      • Retrieves a specific fulfillment order
      • Cancel a fulfillment order
      • Marks a fulfillment order as incomplete
      • Moves a fulfillment order to a new location
      • Marks the fulfillment order as open
      • Reschedules the fulfill_at time of a scheduled fulfillment order
      • Applies a fulfillment hold on an open fulfillment order
      • Sets deadline for fulfillment orders
      • Releases the fulfillment hold on a fulfillment order
    • LocationsForMove
      • Retrieves a list of locations that a fulfillment order can potentially move to.
    • FulfillmentRequest
      • Sends a fulfillment request
      • Accepts a fulfillment request
      • Rejects a fulfillment request
    • FulfillmentService
      • Receive a list of all FulfillmentServices
      • Create a new FulfillmentService
      • Receive a single FulfillmentService
      • Modify an existing FulfillmentService
      • Remove an existing FulfillmentService
  • Shopify Payments
    • Balance
      • Return the current balance
    • Dispute
      • Return a list of all disputes
      • Return a single dispute
    • Payouts
      • Return a list of all payouts
      • Return a single payout
    • Transactions
      • Return a list of all balance transactions
  • Analytics
    • Report
      • Retrieves a list of reports
      • Creates a new report
      • Retrieves a single report
      • Updates a report
      • Deletes a report
  • Deprecated API calls
    • Deprecated API calls
      • Retrieves a list of deprecated API calls
  • Discounts
    • DiscountCode
      • Creates a discount code
      • Retrieves a list of discount codes
      • Updates an existing discount code
      • Retrieves a single discount code
      • Deletes a discount code
      • Retrieves the location of a discount code
      • Retrieves a count of discount codes for a shop
      • Creates a discount code creation job
      • Retrieves a discount code creation job
      • Retrieves a list of discount codes for a discount code creation job
    • PriceRule
      • Creates a price rule
      • Retrieves a list of price rules
      • Updates an existing a price rule
      • Retrieves a single price rule
      • Remove an existing PriceRule
      • Retrieves a count of all price rules
  • Inventory
    • InventoryItem
      • Retrieves a detailed list for inventory items by IDs
      • Retrieves a single inventory item by ID
      • Updates an existing inventory item
    • Location
      • Retrieve a list of locations
      • Retrieve a single location by its ID
      • Retrieve a count of locations
      • Retrieve a list of inventory levels for a location
    • InventoryLevel
      • Retrieves a list of inventory levels
      • Deletes an inventory level from a location
      • Adjusts the inventory level of an inventory item at a location
      • Connects an inventory item to a location
      • Sets the inventory level for an inventory item at a location
  • Events
    • Event
      • Retrieves a list of events
      • Retrieves a single event
      • Retrieves a count of events
    • Webhook
      • Retrieves a list of webhooks
      • Create a new Webhook
      • Receive a count of all Webhooks
      • Receive a single Webhook
      • Modify an existing Webhook
      • Remove an existing Webhook
  • MarketingEvent
    • MarketingEvent
      • Retrieves a list of all marketing events
      • Creates a marketing event
      • Retrieves a count of all marketing events
      • Retrieves a single marketing event
      • Updates a marketing event
      • Deletes a marketing event
      • Creates marketing engagements on a marketing event
  • Metafield
    • Metafield
      • Retrieve a list of metafields from the resource's endpoint
      • Create a metafield
      • Retrieve a list of metafields by using query parameters
      • Retrieve a count of a resource's metafields.
      • Retrieve a specific metafield
      • Updates a metafield
      • Deletes a metafield by its ID
  • Plus
    • Gift Card
      • Retrieves a list of gift cards
      • Creates a gift card
      • Retrieves a single gift card
      • Updates an existing gift card
      • Retrieves a count of gift cards
      • Disables a gift card
      • Searches for gift cards
    • User
      • Retrieves a list of all users
      • Retrieves a single user
      • Retrieves the currently logged-in user
  • Store properties
    • Country
      • Receive a list of all Countries
      • Creates a country
      • Retrieves a count of countries
      • Retrieves a specific county
      • Updates an existing country
      • Remove an existing Country
    • Currency
      • Retrieves a list of currencies enabled on a shop
    • Policy
      • Retrieves a list of the shop's policies
    • ShippingZone
      • Receive a list of all ShippingZones
    • Province
      • Retrieves a list of provinces for a country
      • Retrieves a count of provinces for a country
      • Retrieves a single province for a country
      • Updates an existing province for a country
    • Shop
      • Retrieves the shop's configuration
        GET
  • TenderTransaction
    • TenderTransaction
      • Retrieves a list of tender transactions
  1. Shop

Retrieves the shop's configuration

GET
/admin/api/{api_version}/shop.json
Retrieves the shop's configuration

请求参数

Path 参数
api_version
string 
必需
Query 参数
fields
string 
可选
A comma-separated list of fields to include in the response.

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://demo.myshopify.com//admin/api//shop.json'

返回响应

🟢200Retrieves the shop's configuration
application/json
Body
shop
object (Shop) 
可选
address1
string 
可选
The shop's street address.
address2
string 
可选
The optional second line of the shop's street address.
checkout_api_supported
string 
可选
Whether the shop is capable of accepting payments directly through the Checkout API.
city
string 
可选
The shop's city.
country
string 
可选
The shop's country. In most cases, this value matches the country_code.
country_code
string 
可选
The two-letter country code corresponding to the shop's country.
country_name
string 
可选
The shop's normalized country name.
county_taxes
string 
可选
Whether the shop is applying taxes on a per-county basis. Only applicable to shops based in the US. Valid values: true or null."
created_at
string 
可选
The date and time (ISO 8601) when the shop was created.
customer_email
string 
可选
The contact email used for communication between the shop owner and the customer.
currency
string 
可选
The three-letter code (ISO 4217 format) for the shop's default currency.
domain
string 
可选
The shop's domain.
enabled_presentment_currencies
string 
可选
A list of enabled currencies (ISO 4217 format) that the shop accepts. Merchants can enable currencies from their Shopify Payments settings in the Shopify Admin.
示例值:
CADGBPUSDJPY
eligible_for_card_reader_giveaway
string 
可选
Whether the shop is eligible to receive a free credit card reader from Shopify.
eligible_for_payments
string 
可选
Whether the shop is eligible to use Shopify Payments.
email
string 
可选
The contact email used for communication between Shopify and the shop owner.
finances
string 
已废弃
This field has been deprecated, and is currently unused. Hardcoded to true.
force_ssl
string 
已废弃
As of API version 2021-07, this field has been deprecated and is currently unused. Previously indicated whether the shop forced requests made to its resources to be made over SSL using the HTTPS protocol. All requests now use HTTPS, so force_ssl is always true.
google_apps_domain
string 
可选
The GSuite URL for the store, if applicable.
google_apps_login_enabled
string 
可选
Whether the GSuite login is enabled. Shops with this feature will be able to log in through the GSuite login page. Valid values: true, null
has_discounts
string 
可选
Whether any active discounts exist for the shop.
has_gift_cards
string 
可选
Whether any active gift cards exist for the shop.
has_storefront
string 
可选
Whether the shop has an online store.
iana_timezone
string 
可选
The name of the timezone assigned by the IANA.
id
string 
可选
The ID for the shop. A 64-bit unsigned integer.
latitude
string 
可选
The latitude of the shop's location.
longitude
string 
可选
The longitude of the shop's location.
money_format
string 
可选
A string representing the way currency is formatted when the currency isn't specified.
money_in_emails_format
string 
可选
A string representing the way currency is formatted in email notifications when the currency isn't specified.
money_with_currency_format
string 
可选
A string representing the way currency is formatted when the currency is specified.
money_with_currency_in_emails_format
string 
可选
A string representing the way currency is formatted in email notifications when the currency is specified.
multi_location_enabled
string 
已废弃
This field has been deprecated, and is currently unused. Hardcoded to true.
myshopify_domain
string 
可选
The shop's .myshopify.com domain.
name
string 
可选
The name of the shop.
password_enabled
string 
可选
Whether the password protection page is enabled on the shop's online store.
phone
string 
可选
The contact phone number for the shop.
plan_display_name
string 
可选
The display name of the Shopify plan the shop is on.
pre_launch_enabled
string 
可选
Whether the pre-launch page is enabled on the shop's online store.
cookie_consent_level
string 
可选
The cookie consent level defined on the shop's online store.
plan_name
string 
可选
The name of the Shopify plan the shop is on.
primary_locale
string 
可选
The shop's primary locale, as configured in the language settings of the shop's theme.
primary_location_id
string 
已废弃
Formerly used for the ID of the shipping origin location (read only).
province
string 
可选
The shop's normalized province or state name.
province_code
string 
可选
The two- or three-letter code for the shop's province or state.
requires_extra_payments_agreement
string 
可选
Whether the shop requires an extra Shopify Payments agreement.
setup_required
string 
可选
Whether the shop has any outstanding setup steps.
shop_owner
string 
可选
The username of the shop owner.
source
string 
可选
The handle of the partner account that referred the merchant to Shopify, if applicable.
taxes_included
string 
可选
Whether applicable taxes are included in product prices. Valid values: true or null.
tax_shipping
string 
可选
Whether taxes are charged for shipping. Valid values: true or false.
timezone
string 
可选
The name of the timezone the shop is in.
transactional_sms_disabled
string 
可选
Whether transactional SMS sent by Shopify are disabled on the shop's online store.
updated_at
string 
可选
The date and time (ISO 8601) when the shop was last updated.
weight_unit
string 
可选
The default unit of weight measurement for the shop.
zip
string 
可选
The shop's zip or postal code.
marketing_sms_consent_enabled_at_checkout
string 
可选
Whether SMS marketing has been enabled on the shop's checkout configuration settings.
示例
{
    "shop": {
        "id": 548380009,
        "name": "John Smith Test Store",
        "email": "j.smith@example.com",
        "domain": "shop.apple.com",
        "province": "California",
        "country": "US",
        "address1": "1 Infinite Loop",
        "zip": "95014",
        "city": "Cupertino",
        "source": null,
        "phone": "1231231234",
        "latitude": 45.45,
        "longitude": -75.43,
        "primary_locale": "en",
        "address2": "Suite 100",
        "created_at": "2007-12-31T19:00:00-05:00",
        "updated_at": "2023-01-03T12:55:05-05:00",
        "country_code": "US",
        "country_name": "United States",
        "currency": "USD",
        "customer_email": "customers@apple.com",
        "timezone": "(GMT-05:00) Eastern Time (US & Canada)",
        "iana_timezone": "America/New_York",
        "shop_owner": "John Smith",
        "money_format": "${{amount}}",
        "money_with_currency_format": "${{amount}} USD",
        "weight_unit": "lb",
        "province_code": "CA",
        "taxes_included": null,
        "auto_configure_tax_inclusivity": null,
        "tax_shipping": null,
        "county_taxes": true,
        "plan_display_name": "Shopify Plus",
        "plan_name": "enterprise",
        "has_discounts": true,
        "has_gift_cards": true,
        "myshopify_domain": "jsmith.myshopify.com",
        "google_apps_domain": null,
        "google_apps_login_enabled": null,
        "money_in_emails_format": "${{amount}}",
        "money_with_currency_in_emails_format": "${{amount}} USD",
        "eligible_for_payments": true,
        "requires_extra_payments_agreement": false,
        "password_enabled": false,
        "has_storefront": true,
        "eligible_for_card_reader_giveaway": false,
        "finances": true,
        "primary_location_id": 655441491,
        "cookie_consent_level": "implicit",
        "visitor_tracking_consent_preference": "allow_all",
        "checkout_api_supported": true,
        "multi_location_enabled": true,
        "setup_required": false,
        "pre_launch_enabled": false,
        "enabled_presentment_currencies": [
            "USD"
        ],
        "transactional_sms_disabled": false,
        "marketing_sms_consent_enabled_at_checkout": false
    }
}
修改于 2023-01-29 12:00:35
上一页
Updates an existing province for a country
下一页
Retrieves a list of tender transactions
Built with