The store API: read the store's details and test the key
The reference for the store address of the ArabyBot store API: the response, read and write keys, the limits, and the refusals.
On this page 6
The short answer
With a GET request to the store address of the store API and the store key in the header. The response returns the store's name, currency, country, status and public address. It is the first request to try after creating the key in the store settings, because it changes nothing.
Also asked as: «اربط متجري بسيستم تاني ازاي» · «api المتجر» · «store api key test» · «connect my store to zapier or n8n»
The address and authentication
GET https://app.arabybot.com/store_api/v1/store
Send the store key in the header Authorization: Bearer abst_… or X-Api-Key. You create the key in the store settings; it is shown once and sees only its own store. This address accepts a read key or a write key.
An example request
cURL
curl https://app.arabybot.com/store_api/v1/store \ -H "Authorization: Bearer abst_YOUR_STORE_KEY"
PHP
$ch = curl_init('https://app.arabybot.com/store_api/v1/store');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer abst_YOUR_STORE_KEY'],
]);
$answer = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch); Python
import requests
r = requests.get(
'https://app.arabybot.com/store_api/v1/store',
headers={
"Authorization": "Bearer abst_YOUR_STORE_KEY",
},
timeout=30,
)
print(r.status_code, r.json()) Node.js
// Node.js 18+
const r = await fetch('https://app.arabybot.com/store_api/v1/store', {
headers: {"Authorization": "Bearer abst_YOUR_STORE_KEY"},
});
console.log(r.status, await r.json());
The response
200
{ "ok": true, "id": 12, "name": "My Shop", "currency": "EGP", "country": "EG",
"status": "…", "url": "https://…" } - Every successful response has
"ok": true, and every refusal has"ok": falsewith the code inerror.
The refusals
Every refusal comes back as JSON with "ok": false and the code in error:
- 401
unauthorized: The key is missing, wrong or revoked. - 402
store_plan_closed: The store plan has ended; renew it. - 429: More than 120 requests in a minute.
- 500
server_error: A failure on our side; try again.
The limits
120 requests a minute from one IP address; passing that returns status 429. A store can have up to five keys. A key sees only its own store, and the store's plan must be active.
All store API addresses · All APIs for developers
Frequently asked questions
Where do I create the store API key?
In the store settings. The key starts with abst_ and is shown once, and you pick read or write access for it. A store can have up to five keys.
Which tools does the store API work with?
With any system that sends HTTP requests: automation tools such as n8n, Zapier and Make, or your own stock or accounting system.
Read next
Try the agent before you pay anything
The agent that will answer your customers is the one answering you now: ask it from the chat button here or on WhatsApp. Your account is free with no credit card, and the free trial on your own number or page is activated after you contact our team on customer-service WhatsApp.