Logo
  • خانه
  • مستندات
  • بلاگ
  • تعرفه ها
  • ورود
Logo

راهنمای استفاده از API هوش سرویس

این مستند نحوه برقراری ارتباط با API هوش سرویس را توضیح می‌دهد. این API از طریق متد POST داده‌ها را دریافت و خروجی را در قالب JSON ارائه می‌دهد.

مشخصات API

  • متد درخواست: POST
  • آدرس API: https://YOUR API URL/{action}
  • پارامترهای ورودی:
    • token: کلید API برای احراز هویت
    • query: محتوای درخواست
    • action: نوع درخواست (مثلاً text, html, image و ...)، به‌صورت پارامتر مسیر در URL
  • ساختار خروجی (JSON):

{

"status": "success",

"result": "پاسخ هوش مصنوعی"

}

 

  • نمونه خروجی در صورت خطا:

{

"status": "error",

"message": "توضیحات خطا"

}

 


نمونه درخواست در زبان‌های مختلف

۱. PHP (با استفاده از cURL)

function hooshservice($token, $query, $action = "text") {

$url = 'https://YOUR API URL/' . $action;

$data = http_build_query([

'token' => $token,

'query' => $query

]);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);

curl_setopt($ch, CURLOPT_POST, true);

curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

curl_setopt($ch, CURLOPT_HTTPHEADER, [

'Authorization: ' . $token

]);

$response = curl_exec($ch);

$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

curl_close($ch);

if ($httpCode == 200) {

return json_decode($response, true);

} else {

return ["status" => "error", "message" => "connection error"];

}

}

 

۲. C# (با استفاده از HttpClient)

using System;

using System.Collections.Generic;

using System.Net.Http;

using System.Threading.Tasks;

using Newtonsoft.Json;

class Program

{

static async Task Main()

{

using (HttpClient client = new HttpClient())

{

var values = new Dictionary<string, string>

{

{"token", "API_KEY"},

{"query", "یک مقاله در رابطه با فواید سیب بنویس"}

};

var content = new FormUrlEncodedContent(values);

client.DefaultRequestHeaders.Add("Authorization", "API_KEY");

var response = await client.PostAsync("https://YOUR API URL/text", content);

string result = await response.Content.ReadAsStringAsync();

var jsonResponse = JsonConvert.DeserializeObject<Dictionary<string, string>>(result);

Console.WriteLine(jsonResponse["result"]);

}

}

}

 

۳. Python (با استفاده از requests)

import requests

url = "https://YOUR API URL/text"

data = {

"token": "API_KEY",

"query": "یک مقاله در رابطه با فواید سیب بنویس"

}

headers = {

"Authorization": "API_KEY"

}

response = requests.post(url, data=data, headers=headers)

if response.status_code == 200:

print(response.json()["result"])

else:

print(f"خطا ({response.status_code}): {response.json()["message"]}")

 

۴. JavaScript (Node.js با استفاده از Axios)

const axios = require('axios');

const data = new URLSearchParams({

token: 'API_KEY',

query: 'یک مقاله در رابطه با فواید سیب بنویس'

});

axios.post('https://API URL/text', data, {

headers: { 'Authorization': 'API_KEY' }

})

.then(response => {

console.log(response.data.result);

})

.catch(error => {

console.error(`خطا (${error.response.status}): ${error.response.data.message}`);

});

 

۵. Java (با استفاده از HttpURLConnection)

import java.io.*;

import java.net.*;

public class APIRequest {

public static void main(String[] args) throws Exception {

URL url = new URL("https://YOUR API URL/text");

HttpURLConnection conn = (HttpURLConnection) url.openConnection();

conn.setRequestMethod("POST");

conn.setDoOutput(true);

conn.setRequestProperty("Authorization", "API_KEY");

String data = "token=API_KEY&query=یک مقاله در رابطه با فواید سیب بنویس";

try (OutputStream os = conn.getOutputStream()) {

os.write(data.getBytes());

os.flush();

}

int responseCode = conn.getResponseCode();

BufferedReader reader = new BufferedReader(new InputStreamReader(

responseCode == 200 ? conn.getInputStream() : conn.getErrorStream()

));

String line;

while ((line = reader.readLine()) != null) {

System.out.println(line);

}

reader.close();

}

}

 


نحوه دریافت پاسخ از API

  • اگر وضعیت HTTP برابر 200 باشد، خروجی به‌صورت JSON شامل status: success و نتیجه در فیلد result خواهد بود.
  • اگر وضعیت HTTP غیر از 200 باشد، خروجی JSON شامل status: error و فیلد message که توضیح خطا را ارائه می‌دهد خواهد بود.

نکات امنیتی

  • همیشه API_KEY خود را مخفی نگه دارید.
  • از ارتباطات HTTPS برای امنیت بیشتر استفاده کنید.
  • درخواست‌ها را لاگ‌گیری کنید تا در مواقع اشکال‌یابی بتوانید مشکل را بررسی کنید.

نتیجه‌گیری

با استفاده از این مستند، توسعه‌دهندگان می‌توانند به راحتی با API هوش سرویس ارتباط برقرار کرده و درخواست‌های خود را ارسال کنند. این API اکنون از خروجی JSON پشتیبانی می‌کند که استانداردسازی بیشتری را فراهم می‌آورد.

 

محصولات دیگر

سرزمین گرافیک
رومینو:سامانه برگزاری وبینار و کلاس آنلاین
واپیا:ربات ارسال انبوه واتساپ
سیم وب:سایت ساز آنلاین
easyfollower:افزایش فالوور واقعی اینستاگرام
سیمینCrm:سامانه مدیریت ارتباط با مشتری

هوش سرویس ؛ ارائه خدمات هوش مصنوعی

  • ما در هوش سرویس به عنوان یک ارائه‌دهنده پیشرو در خدمات API هوش مصنوعی، به شما کمک می‌کنیم تا توانایی‌های کسب‌وکار خود را با استفاده از فناوری‌های نوین به حداکثر برسانید. APIهای ما به شما این امکان را می‌دهند که به سادگی و با سرعت، قابلیت‌های هوش مصنوعی را در پروژه‌های خود پیاده‌سازی کنید

راه های ارتباطی

+(98) 917 319 8608 info@Hooshservice.ir

نیاز به راهنمایی دارید ؟

سوال خود را از پشتیبانی بپرسید

ارسال پیام

تمامی حقوق این سایت برای هوش سرویس محفوظ است