فهرست شرکت‌ها
حرفه‌ایکلید خواندندر پلن حرفه‌ای و سازمانی در دسترس است (بتا).
GEThttps://app.reshta.ir/api/v1/public…/public/companies
شرکت‌ها را صفحه‌به‌صفحه برمی‌گرداند؛ تازه‌ترین اول.
درخواست
curl https://app.reshta.ir/api/v1/public/companies \ -H "Authorization: Bearer $RESHTA_API_KEY"سرآیندها
AuthorizationstringالزامیBearer و کلید API کسب‌وکار (rk_live_…).
پارامترهای جستجو
owner_idstringاختیاریفقط رکوردهای این همکار.
qstringاختیاریمتن جستجو.
cursorstringاختیاریnext_cursor پاسخ قبلی؛ برای صفحهٔ اول نفرستید.
limitstringاختیاریاندازهٔ صفحه؛ پیش‌فرض ۵۰، بیشینه ۱۰۰.
پاسخ‌ها و خطاها
200—موفق.
401unauthorizedکلید نیست، نادرست یا باطل است، یا سازنده‌اش دیگر فعال نیست.
429rate_limitedبیش از ۱۲۰ درخواست در دقیقه؛ Retry-After می‌گوید چند ثانیه صبر کنید.
پاسخ
401
{ "error": { "code": "unauthorized", "message": "An API key is required: Authorization: Bearer <key>", "details": [ { "field": "authorization", "message": "api_key_missing" } ] }}