Asosiy qismga o'tish

Boshlash · 3-bob

Autentifikatsiya

Har bir API so'rovi maxfiy API kalitingiz bilan tasdiqlanadi. Bu bo'limda kalitni qanday yuborish, uni serverlaringizga qanday bog'lash va webhook imzosi qanday ishlashi ko'rsatilgan.

1 daqiqa o'qish

API kalitlari

Kalitlarni panelda API kalitlari bo'limida yarating. Bir vaqtda 10 tagacha faol kalitingiz bo'lishi mumkin, masalan har bir server yoki loyiha uchun bittadan. To'liq kalit gxp_xxxxxxxxxxxx_xxxx… ko'rinishida bo'ladi va faqat bir marta ko'rsatiladi; biz faqat uning xeshini saqlaymiz. Kalit begonalar qo'liga tushsa, uni panelda o'chiring va yangisini yarating — eski kalit darhol ishlamay qoladi.

Kalitni yuborish

Kalitni quyidagi sarlavhalardan birida yuboring:

Authorization: Bearer gxp_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
X-Api-Key: gxp_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Barcha so'rovlar HTTPS orqali bo'lishi shart. Yaroqli kalitsiz so'rovlar 401 UNAUTHENTICATED oladi.

Ruxsat etilgan IP manzillar

Kalitni faqat ma'lum IP manzillar yoki CIDR oraliqlari bilan cheklashingiz mumkin (masalan 203.0.113.10 yoki 203.0.113.0/24). Boshqa manzillardan kelgan so'rovlar 403 IP_NOT_ALLOWED oladi. Buni har bir ishchi kalit uchun tavsiya qilamiz.

Hisob holati

Live kalitlar faqat hisobingiz tasdiqlangan paytda ishlaydi. Hisob hali tasdiqlanmagan yoki to'xtatilgan bo'lsa, har bir live so'rov 403 ACCOUNT_NOT_ACTIVE oladi.

Test kalitlari (gxp_test_…) tasdiqlanishdan oldin ham ishlaydi, shuning uchun integratsiyani darhol qurib, sinab ko'rishingiz mumkin. Faqat rad etilgan yoki to'xtatilgan hisoblar yopiladi. Sandbox bobiga qarang.

Webhook imzosi

API ga so'rovlar uchun imzo kerak emas — kalitning o'zi yetarli. Teskari yo'nalishda esa biz serveringizga yuboradigan har bir webhook webhook maxfiy kalitingiz bilan X-Partner-Signature sarlavhasida imzolanadi:

X-Partner-Signature: t=1763200934,v1=5f2c…

v1 — bu "{t}.{raw body}" qiymatining webhook maxfiy kalitingiz bilan olingan HMAC-SHA256 si, hex ko'rinishida. Uni PHP, Node.js va Python da qanday tekshirish Webhooklar bo'limida ko'rsatilgan.