VK.watch API
साइट जैसा ही डेटा, HTTP पर। API पैक खरीदें, कुंजी बनाएँ और प्रति अनुरोध क्रेडिट चुकाएँ।
API पैक
$99 API: 2,000 क्रेडिट, 30 दिन
- भुगतान के बाद API पहुँच 30 दिन के लिए खुलती है; अवधियाँ जुड़ती हैं।
- क्रेडिट खरीद के बाद 365 दिन तक मान्य हैं; पहले वे खर्च होते हैं जो पहले समाप्त होते हैं।
- API क्रेडिट एक अलग वॉलेट है; साइट उन्हें कभी खर्च नहीं करती।
- API पैक नहीं है? साइट पहुँच सक्रिय रहते हुए API कॉल उन्हीं दामों पर साइट क्रेडिट खर्च करती हैं। परीक्षण के लिए उपयोगी।
- एकमुश्त क्रिप्टो भुगतान, कोई स्वतः नवीनीकरण नहीं।
सीमाएँ
- 5 अनुरोध प्रति सेकंड, 20 तक बर्स्ट
- प्रति खाता 5 तक सक्रिय कुंजियाँ
- विफल अनुरोध (4xx/5xx) का रिफंड होता है
- हर अनुरोध का शुल्क लगता है; वही प्रोफ़ाइल दोबारा माँगने पर फिर शुल्क लगता है
प्रमाणीकरण
अपने खाते में कुंजी बनाएँ और उसे Bearer टोकन के रूप में भेजें। हर उत्तर में X-Credits-Charged और X-Credits-Remaining हेडर होते हैं।
curl -H "Authorization: Bearer $VKWATCH_API_KEY" \ https://api.vk.watch/v1/profile/1
उत्तर JSON लिफ़ाफ़े {response, meta} हैं। खोज का उत्तर बिना लिफ़ाफ़े के लौटता है।
{
"response": { "id": 1, "profile": { "first_name": "…", "last_name": "…", "city": { "title": "…" } }, "photos": 12, "friends": 341 },
"meta": { "credits": { "charged": 2, "remaining": 1998 } }
}एंडपॉइंट
बेस URL: https://api.vk.watch/v1
| मार्ग | लौटाता है | क्रेडिट |
|---|---|---|
| GET/me | endpoints.notes.balance | 0 |
| GET/profile/{id} | काउंटर सहित नवीनतम प्रोफ़ाइल स्नैपशॉट | 2 |
| GET/profile/{id}/changes | समय के साथ फ़ील्ड बदलाव | 2 |
| GET/profile/{id}/snapshots | संग्रहीत स्नैपशॉट की सूची | 1 |
| GET/profile/{id}/snapshot/{snapshotId} | एक ऐतिहासिक स्नैपशॉट | 2 |
| GET/profile/{id}/friends | मित्र सूची | 2 |
| GET/profile/{id}/photos | फ़ोटो | 2 |
| GET/profile/{id}/comments | टिप्पणियाँ | 1 |
| GET/profile/{id}/identity | केवल नाम और अवतार | 1 |
| GET/search?name=… | फ़ेसेटेड खोज (एक पृष्ठ = 50 परिणाम) | 1 |
| POST/lookup | id और स्क्रीन नाम हल करें | 1 |
| GET/geo/search, /geo/resolve, /facets/suggest | जियो और फ़ेसेट सहायक (निःशुल्क) | 0 |
| POST/faces (multipart photo) | फ़ोटो से चेहरा खोज | 20 |
मशीन-पठनीय विनिर्देश: openapi.json
आज़माएँ
पैरामीटर भरें और यहीं से अनुरोध भेजें। यह आपके सत्र से चलता है और कुंजी कॉल की तरह ही शुल्क लेता है।
काउंटर सहित नवीनतम प्रोफ़ाइल स्नैपशॉट
curl -H "Authorization: Bearer $VKWATCH_API_KEY" \ "https://api.vk.watch/v1/profile/1"
त्रुटियाँ
401 apiKeyRequired / apiKeyInvalid— कुंजी अनुपस्थित या रद्द402 apiAccessExpired / apiCreditsExhausted— API पहुँच अवधि नहीं या क्रेडिट अपर्याप्त; कुछ शुल्क नहीं404 profileNotFound— अज्ञात प्रोफ़ाइल; कुछ शुल्क नहीं429 apiRateLimited— दर सीमा; एक सेकंड बाद पुनः प्रयास करें