مقدمه
این سایت یک api مناسبت ها و تعطیلات تقویم رسمی جمهوری اسلامی ایران میباشد.
تمامی داده های این api از وبسایت time.ir استخراج شده.
تقدیم به ایرانیان سراسر جهان
پ.ن:
این API رو آبان ۱۴۰۱ ساختم، بدون اینکه فکر کنم کسی واقعاً ازش استفاده کنه.
حدود یک سال بعد یادم افتاد چک کنم ببینم اصلاً کسی استفاده کرده یا نه، که واقعاً شوکه شدم 😄
تا الان (اردیبهشت ۱۴۰۴) بیشتر ۱۱۰ میلیون ریکوئست بهش زده شده و الان بهطور میانگین روزانه داره به ۲۵۰ هزار درخواست جواب میده
آمار امروز : ۸,۵۴۰ ریکوئست
ممنون از حمایتتون ❤️
استفاده شمسی
برای استفاده کافیست یک ریکوئست GET به آدرس زیر بزنید
GET https://holidayapi.ir/jalali/{year}}/{month}/{day}
نحوه استفاده :
use GuzzleHttp\Client;
$client = new Client();
$url = 'https://holidayapi.ir/jalali/1403/06/02';
$response = $client->get($url);
$data = json_decode($response->getBody(), true);
print_r($data);
// Or use file_get_contents()
$data = json_decode(file_get_contents($url), true);
print_r($data);
import requests
url = 'https://holidayapi.ir/jalali/1403/06/02'
response = requests.get(url)
data = response.json()
print(data)
const axios = require('axios');
const url = 'https://holidayapi.ir/jalali/1403/06/02';
axios.get(url)
.then(response => {
console.log(response.data);
})
.catch(error => {
console.error(error);
});
require 'net/http'
require 'json'
require 'uri'
url = URI.parse('https://holidayapi.ir/jalali/1403/06/02')
response = Net::HTTP.get(url)
data = JSON.parse(response)
puts data
import 'dart:convert';
import 'package:http/http.dart' as http;
void main() async {
final url = Uri.parse('https://holidayapi.ir/jalali/1403/06/02');
final response = await http.get(url);
if (response.statusCode == 200) {
final data = jsonDecode(response.body);
print(data);
} else {
print('Request failed with status: ${response.statusCode}.');
}
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class HolidayApiExample {
public static void main(String[] args) throws Exception {
String url = "https://holidayapi.ir/jalali/1403/06/02";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
استفاده میلادی
برای استفاده کافیست یک ریکوئست GET به آدرس زیر بزنید
GET https://holidayapi.ir/gregorian/{year}}/{month}/{day}
نحوه استفاده :
use GuzzleHttp\Client;
$client = new Client();
$url = 'https://holidayapi.ir/gregorian/2024/08/23';
$response = $client->get($url);
$data = json_decode($response->getBody(), true);
print_r($data);
// Or use file_get_contents()
$data = json_decode(file_get_contents($url), true);
print_r($data);
import requests
url = 'https://holidayapi.ir/gregorian/2024/08/23'
response = requests.get(url)
data = response.json()
print(data)
const axios = require('axios');
const url = 'https://holidayapi.ir/gregorian/2024/08/23';
axios.get(url)
.then(response => {
console.log(response.data);
})
.catch(error => {
console.error(error);
});
require 'net/http'
require 'json'
require 'uri'
url = URI.parse('https://holidayapi.ir/gregorian/2024/08/23')
response = Net::HTTP.get(url)
data = JSON.parse(response)
puts data
import 'dart:convert';
import 'package:http/http.dart' as http;
void main() async {
final url = Uri.parse('https://holidayapi.ir/gregorian/2024/08/23');
final response = await http.get(url);
if (response.statusCode == 200) {
final data = jsonDecode(response.body);
print(data);
} else {
print('Request failed with status: ${response.statusCode}.');
}
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class HolidayApiExample {
public static void main(String[] args) throws Exception {
String url = "https://holidayapi.ir/gregorian/2024/08/23";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
پاسخ وب سرویس
وب سرویس به صورت یک json حاوی مناسبت های روز به شما پاسخ خواهد داد
پاسخ وب سرویس :
{
"is_holiday": true,
"events": [
{
"description": "جمعه",
"additional_description": "",
"is_holiday": true,
"is_religious": false
},
{
"description": "آغاز هفته دولت",
"additional_description": "",
"is_holiday": false,
"is_religious": false
},
{
"description": "درگذشت جان کندرو بیوشیمیست انگلیسی، برندهٔ جایزه نوبل شیمی سال ۱۹۶۲",
"additional_description": "23 August",
"is_holiday": false,
"is_religious": false
}
]
}
حمایت
در صورتی که این API به کارتون اومده، میتونید از این پروژه حمایت کنید
Coin | Address |
---|---|
BTC | bc1qhqq5uq5ja5n6nzpp0k9rmfwt9648wjektpj6t9 |
ETH | 0x61B8D468f6CD5566550Aad6205304E896cAC5146 |
DOGE | D5q1v1PdUsto9VuGEq5Xkq6cuVQy6VJ7tz |
TRX | TYpAenm5EMTViyU5E2RSfvXcVFPLxBr55i |
TON | UQD2IURNboiAKprP7xBj_nM6pp1QL6Ao2vFswSMkU5AWPC8r |
BNB | 0x61B8D468f6CD5566550Aad6205304E896cAC5146 |
XRP | rEtzu921mTdu2NtKwQqFZUQSXzbayGxZ1j |
LTC | ltc1q2kjyuwjnk5lh20c62v756j4qaeetv5qn3yum44 |
یا برای پرداخت ریالی، میتونید از طریق لینک زیر منو به قهوه مهمون کنید: