መጀመር
ማረጋገጫ
እያንዳንዱ ጥያቄ የእርስዎን የAPI ቁልፍ ይይዛል። ቁልፉ ተጠቃሚዎን ይለያል፤ ምላሹ ምን ሊይዝ እንደሚችልም ይወስናል።
- 1በቁጥጥር ፓነሉ ውስጥ የእኔ መለያ › API የሚለውን ይክፈቱ እና ቁልፍ ፍጠር የሚለውን አዝራር ጠቅ ያድርጉ። ቁልፉ የት እንደሚውል የሚያስታውስዎ ስም ይስጡት፤ ለምሳሌ «ክትትል»።
- 2ቁልፉን ወዲያውኑ ይቅዱ፦ ለደህንነት ሲባል የሚታየው አንድ ጊዜ ብቻ ነው። ከጠፋብዎ ይሻሩት እና ሌላ ይፍጠሩ።
- 3ቁልፉን በ
X-API-Keyሄደር ውስጥ ወይም እንደAuthorization: Bearerይላኩ።
ቁልፉን በሰርቨር ላይ ብቻ ይጠቀሙ። በድረ-ገጾች፣ በመተግበሪያዎች ወይም በሊንኮች ውስጥ በጭራሽ አያስቀምጡት፦ API በአድራሻው ውስጥ የተላኩ ቁልፎችን አይቀበልም። እያንዳንዱ ተጠቃሚ እስከ 10 ንቁ ቁልፎች ሊኖሩት ይችላል፤ ማንኛቸውንም በዚያው የቁጥጥር ፓነል ትር ውስጥ መሻር ይችላል።
የቁልፉ ቅርጸት
ቁልፉ በapk_ ይጀምራል፤ ከዚያም 48 ቁምፊዎች ይከተላሉ። በቁጥጥር ፓነሉ ውስጥ እያንዳንዱ ቁልፍ የሚታየው በመጀመሪያው ክፍሉ ብቻ ሲሆን፣ ይህም የ/me የapi_key.prefix መስክ ዋጋ ነው።
ቁልፎችን መሻር እና መቀየር
ቁልፍን መሻር በእሱ የሚላኩ ጥያቄዎችን ወዲያውኑ ያግዳል። ሲስተምዎን ሳያቋርጡ ቁልፉን ለመቀየር አዲሱን ይፍጠሩ፣ በሰርቨርዎ ላይ ይቀይሩት፣ ከዚያ በኋላ ብቻ አሮጌውን ይሻሩ።
ሲስተምዎ የሚያስፈልገው የመረጃውን የተወሰነ ክፍል ብቻ ከሆነ፣ በቁጥጥር ፓነሉ ውስጥ አስፈላጊዎቹ ፈቃዶች ብቻ ያሉት ለእሱ ብቻ የሆነ ተጠቃሚ ይፍጠሩ፤ ቁልፉንም በዚያ ተጠቃሚ መለያ ውስጥ ይፍጠሩ።
ጥያቄ
curl "https://api.on-cloud.live/v1/me" \
-H "X-API-Key: $API_KEY"<?php
$ch = curl_init('https://api.on-cloud.live/v1/me');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('API_KEY')],
]);
$response = json_decode(curl_exec($ch), true);const res = await fetch('https://api.on-cloud.live/v1/me', {
headers: { 'X-API-Key': process.env.API_KEY }
});
const { data } = await res.json();በAuthorization ሄደር
curl "https://api.on-cloud.live/v1/me" \
-H "Authorization: Bearer $API_KEY"ቁልፍ የሌለው ወይም የተሻረ ቁልፍ401
{
"error": {
"code": "invalid_api_key",
"message": "The API key is invalid or has been revoked."
}
}