प्रमाणीकरण
हर रिक्वेस्ट Authorization हेडर में एक bearer टोकन ले जाती है। स्कोप तय करते हैं कि कोई टोकन क्या कर सकता है।
Bearer टोकन
अपनी की को “Authorization: Bearer …” के रूप में भेजो। बिना वैध की के तुम्हें 401 मिलेगा।
Scopes
टोकन को सिर्फ़ वही स्कोप मिलते हैं जो तुमने चुने। उनसे बाहर की रिक्वेस्ट 403 लौटाती है।
टेस्ट और लाइव
टेस्ट की असली डेटा को कभी नहीं छूती। तैयार हो तो लाइव पर स्विच करो।
सीमाएँ, और जब तुम कोई सीमा पार करते हो तो क्या होता है
हर की के लिए दो सीमाएँ होती हैं: एक प्रति मिनट और एक प्रति दिन। इनमें से कोई भी पार होते ही तुम्हें Retry-After हेडर के साथ 429 मिलता है, जो बताता है कि कितनी देर रुकना है — मैसेज तुम्हें बताता है कि तुमने कौन-सी सीमा छुई। अगर कोई की दिन-ब-दिन अपनी सीमा पर टिकी रहती है, तो कोई इंसान उसे देखता है और उसे अस्थायी रूप से बंद किया जा सकता है; तब तुम्हें कारण के साथ 403 मिलता है, ताकि तुम जान सको कि गड़बड़ी हमारी तरफ़ से है, तुम्हारी की में नहीं।