NAV
php python javascript ruby dart java

مقدمه

این سایت یک 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

یا برای پرداخت ریالی، می‌تونید از طریق لینک زیر منو به قهوه مهمون کنید:

پرداخت در CoffeeTe