Verify one card by code, serial or username
GET
/api/v1/cards/search
prm_cards_verify
The counter-staff lookup. Finds a single card and reports its state, its owning reseller and who spent it. Confined to the caller's manager subtree unless they are an administrator.
A card outside your subtree answers the same 404 as an unknown keyword, never a 403 — a 403 would confirm the code exists and turn this into a code-guessing oracle. It carries its own per-operator budget for the same reason, separate from the tenant's.
نظرة سريعة
- المصادقة
- رمز موظّف أو جلسة
- تتطلب صلاحية
-
prm_cards_verifyVerify / redeem cards - حد المعدل
card_search
المعاملات
| المعامل | الوصف |
|---|---|
kindمطلوب
query · enum
|
code, serial or username. |
keywordمطلوب
query · string
|
The value to match. A code is normalised first, so separators and mixed case still resolve. |
الأخطاء
| الرمز | متى تُرجَع |
|---|---|
ERR_NOT_FOUND404
|
no card matches, or the card is outside the caller's subtree |