Publisher quick start
Use a publisher app to identify your server when it calls Comet. Each API also checks the access granted to that app.
Set up your app
- Sign in to the Comet console for the environment you plan to use. Open your publisher organization from the account menu. If you need a publisher organization or membership, contact Comet Support.
- Select an existing app in the sidebar. A publisher administrator can choose Add new app to create one.
- On Home → App credentials, choose Create API key for a new app or Reveal key if the app already has a revealable key. Copy it to your server's secret storage and hide it in the console.
- Share the App client ID with your Comet contact when requesting access. Keep the API key on your server.
See Publisher apps for credential permissions and troubleshooting.
Choose your API
- Creator pages. Ask Comet for the API origin, partner ID, creator onboarding method and grant for your environment. Then follow the Creator Publishing setup to call
GET /capabilitiesfor a verified creator. - Catalog and checkout. Confirm which brand catalog your publisher app can use and obtain its organization ID. Then send the GraphQL request below.
Query an authorized catalog
bash
curl --fail-with-body 'https://api.comet.rocks/graphql' \
-H "x-api-key: ${COMET_API_KEY}" \
-H 'Content-Type: application/json' \
--data '{"query":"query GetProducts($organizationId: ID!) { productFind(organizationId: $organizationId, pagination: { first: 10 }) { nodes { id name { default { text } } } pageInfo { hasNextPage endCursor } } }","variables":{"organizationId":"YOUR_BRAND_ORGANIZATION_ID"}}'This example uses the production GraphQL endpoint. Use your environment's endpoint with a key from the same environment. Check the response's errors field even if the HTTP status is 200.
Continue with product search or the checkout tutorial. To connect a merchant's shop system, use the Merchant Guides.