Api праздники сегодня

Праздники

Добавить новый праздник:

Формат API-запросов для получения праздников

http://htmlweb.ru/service/api.php?holiday — получить список праздников

Дополнительные параметры:
[&private=0|1] — показать только общие праздниики или только личные
Для получения личных праздников дополнительно используйте параметр API_KEY из профиля
[&type=0-3] — показать праздники только определенного вида: 0-Личный,1-Государственный,2-Церковный,3-Профессиональный
[&country=XX] — показать праздники только определенной страны, по умолчанию все.
[&d_from=ДАТА1] — показать только праздники С даты1 в формате дд.мм.гг или дд.мм или YYYY-MM-DD
[&d_to=ДАТА2] — показать только праздники ПО дату2 в формате дд.мм.гг или дд.мм или YYYY-MM-DD
[&birthday] — включить в список дни рождения из Контактов
[&q=XXX] — выбрать праздники содержащие указанный текст
[&perpage=20] — сколько вывести праздников в пакете, по умолчанию 20
[&p=1] — с какого по счету праздника выводить, по умолчанию с 1-го
[&id=NNN] — показать только праздник с номером NNN.

https://htmlweb.ru/service/api.php?holiday_edit — форма добавления праздника

https://htmlweb.ru/service/api.php?holiday_edit=ID — форма редактирования праздника с номером ID

https://htmlweb.ru/service/api.php?holiday_del=ID — удалить праздник с номером ID

https://htmlweb.ru/service/api.php?holiday_save — добавить новый праздник или отредактировать существующий

Дополнительные параметры:
[&id=NNN] — номер записи, если не указан будет добавлен новый праздник.
&name=НАЗВАНИЕ_ПРАЗДНИКА
Дата праздника указывается одним из следующих полей:
[&date=ДД.ММ.ГГГГ] — дата праздника для одноразовых
[&month=МЕСЯЦ&day=ДЕНЬ] — дата праздника для ежегодных
[&holiday=ММДД]
[&country=RU] — двухбуквенный код страны праздника, по умолчанию RU-Россия. Список стран с кодами.
[&comment=ОПИСАНИЕ_ПРАЗДНИКА]
[&type=0-3] вид праздника 0-Личный, 1-Государственный, 2-Церковный, 3-Профессиональный, 4-Неофициальный(невыходной),

Для получения личных праздников используйте параметр API_KEY из вашего профиля

Где ещё можно взять информацию о праздничных днях, рабочих днях и т.п.:
http://kayaposoft.com/enrico/json/v1.0/?action=getPublicHolidaysForMonth&month=1&year=2014&country=rus
http://www.timeanddate.com/holidays/russia/2014
http://api1.vasha-ats.ru/daytype.php?date=Y-m-d
http://www.calend.ru/img/export/today-holidays.rss — ближайшие праздники на 2 дня

Welcome to the Calendarific Global Holidays API. We cover over 230 countries and 3000 states around
the
world. We are constantly adding new countries and states. Feel free to send us an email if your
country is not included in the list. This document covers how to use our API. Let us know if you have
any questions.

The Calendarific API is built on REST principles. Authenticated users can interact with any of our
URIs by using the specified HTTP request method. We enforce using SSL encryption by issuing requests
through HTTPS.

API Base URL

All requests to our API are supposed to be sent to this endpoint. Below you will find a list of
endpoints that the API supports

https://calendarific.com/api/v2

API Endpoints

Below is a list of API endpoints we currently support. Please note that requests to any of these
endpoints count towards your API hits quota. If you are on the free plan it will count towards your
allotments.

Authentication

An API key is required for every request to the Holiday API. Your API key is used to authenticate you
with our API, and it should be provided as a
api_key URL parameter.

The API key can be retrieved from the account pages. If you do know your API key please signup for a free account key.

?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs

The api_key should be appended to the url request like in the example below

 curl -G https://calendarific.com/api/v2/holidays?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs

Holiday API Endpoint Parameters

Queries are made to our API using URL parameters. There are two sets of parameters,
optional and required. For the holidays API. The country, the
year and api_key are required parameters for all holiday API requests.
Requests that do not have the required parameter will receive an error response and cannot be
processed.

Required API Parameters

Below is an example request for all holidays in the United States for 2019. Be sure to replace
the api_key with a valid value from your account page.

curl 'https://calendarific.com/api/v2/holidays?&api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs&country=US&year=2019'

Below is a shortened API response that executes successfully

{
    "meta": {
        "code": 200
    },
    "response": {
        "holidays": [
            {
                "name": "Name of holiday goes here",
                "description": "Description of holiday goes here",
                "date": {
                    "iso": "2018-12-31",
                    "datetime": {
                        "year": 2018,
                        "month": 12,
                        "day": 31
                    }
                },
                "type": [
                    "Type of Observance goes here"
                ]
            }
        ]
    }
}

Optional Holiday API Endpoint Parameters

Our API has a list of optional parameters that allow users to refine the results that gets
returned. Please note that some of the optional parameters are only limited to paid users. Below
is the complete list of optional parameters

NB: Multiple types can be specified in the request separated by commas.

Premium Holiday API Endpoint Parameters

Our API supports premium parameters which are available to all users of our professional plan
and above. You will receive an error if you use these parameters without the required
subscription.

HTTP response codes

Every API request returns an appropriate HTTP response code and below is a list of what they
mean
with regards to the API

API error codes

Whenever the Calendarific server detects an input error it will return an HTTP 422 status
code
along with a JSON object containing error details:

JSON Response

We try to automatically detect when someone wants to call our API vs view our website, and
send
back the appropriate JSON response rather than HTML. We do this based on the user agent for
known popular programming languages, tools and frameworks. There are a couple of other ways
to
force a JSON response from us in the cases that it doesn’t happen automatically though. One
is
to add /json to the URL, and the other is to set an accepts header to application/json:

Rate Limits

Free usage of our API is limited to 1,000 API requests per day. If you exceed 1,000 requests
in
a 24 hour period we’ll return a 429 HTTP status code to you. Paid plans come with monthly
limits, and configurable alerts.

JSONP/CORS Requests

JSONP and CORS are supported, allowing you to use Calendarific entirely in client-side code.
For
JSONP You just need to specify the callback parameter, eg.
https://calendarific.com/?callback=callback. Most javascript libraries will
automatically handle this for you though.

Required Request Parameters

country
string

For countries, ISO 3166-1 alpha-2
or ISO 3166-1 alpha-3 format.
For states / provinces (with our States & Provinces plan), ISO 3166-2 format.
Accepts up to 10 comma separated values.

Full list of supported countries and states / provinces.

key
string

Your API key.

year
postive integer

4 digit year in ISO 8601 format.

Optional Request Parameters

month
positive integer

1 or 2 digit month (1-12).

day
positive integer

1 or 2 digit day (1-31 depending on the month). Must be used with month.

public
boolean

Return only public holidays.

subdivisions
boolean

Return state / province holidays alongside countrywide holidays. Available on our States & Provinces plan.

search
string

Search holidays by name. Minimum 5 characters.

language
string

ISO 639-1 format (with exceptions).

Full list of supported languages.

previous
boolean

Return the first day of holidays that occur before the specific date.
month and day are required.
Cannot be used with upcoming.

upcoming
boolean

Return the first day of holidays that occur after the specific date.
month and day are required.
Cannot be used with previous.

format
string

Response format (csv, json, php, tsv, yaml and xml). Defaults to JSON.

pretty
boolean

Prettifies results to be more human-readable.

Return Properties

status
number

Status code for the response.

requests
dictionary

Rate limit information for the current month.

holidays
array of dictionaries

List of holidays based on your request parameters.

Optional Return Properties

error
string

Textual explanation of the error that ocurred.

warning
string

Additional information about the data that was returned.

holidays.subdivisions
array of strings

List of applicable subdivisions when using the subdivisions request parameter. Empty array denotes all subdivisions are applicable.

Sample Holidays Response

{
    "status": 200,
  + "requests": { ... },
  - "requests": {
        "used": 774,
        "available": 226,
        "resets": "2023-03-01 00:00:00"
    },
  + "holidays": [ ... ]
  - "holidays": [
        {
            "name": "New Year's Day",
            "date": "2015-01-01",
            "observed": "2015-01-01",
            "public": true,
            "country": "US",
            "uuid": "82f78b8a-019e-479e-a19f-99040275f9bf",
            "weekday": {
                "date": {
                    "name": "Thursday",
                    "numeric": 4
                },
                "observed": {
                    "name": "Thursday",
                    "numeric": 4
                }
            }
        },
        {
            "name": "Mother's Day",
            "date": "2015-05-10",
            "observed": "2015-05-10",
            "public": false,
            "country": "US",
            "uuid": "0746cfc7-6432-4dcc-bc75-dfef56c41086",
            "weekday": {
                "date": {
                    "name": "Sunday",
                    "numeric": 7
                },
                "observed": {
                    "name": "Sunday",
                    "numeric": 7
                }
            }
        },
        {
            "name": "Independence Day",
            "date": "2015-07-04",
            "observed": "2015-07-03",
            "public": true,
            "country": "US",
            "uuid": "88268759-9b90-468c-804f-b729b8418e7c",
            "weekday": {
                "date": {
                    "name": "Saturday",
                    "numeric": 6
                },
                "observed": {
                    "name": "Friday",
                    "numeric": 5
                }
            }
        }
    ]
}

[
   {
      "date": "2017-01-01",
      "localName": "Neujahr",
      "name": "New Year's Day",
      "countryCode": "AT",
      "fixed": true,
      "global": true,
      "counties": null,
      "launchYear": 1967,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-01-06",
      "localName": "Heilige Drei Könige",
      "name": "Epiphany",
      "countryCode": "AT",
      "fixed": true,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-04-17",
      "localName": "Ostermontag",
      "name": "Easter Monday",
      "countryCode": "AT",
      "fixed": false,
      "global": true,
      "counties": null,
      "launchYear": 1642,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-05-01",
      "localName": "Staatsfeiertag",
      "name": "National Holiday",
      "countryCode": "AT",
      "fixed": true,
      "global": true,
      "counties": null,
      "launchYear": 1955,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-05-25",
      "localName": "Christi Himmelfahrt",
      "name": "Ascension Day",
      "countryCode": "AT",
      "fixed": false,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-06-05",
      "localName": "Pfingstmontag",
      "name": "Whit Monday",
      "countryCode": "AT",
      "fixed": false,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-06-15",
      "localName": "Fronleichnam",
      "name": "Corpus Christi",
      "countryCode": "AT",
      "fixed": false,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-08-15",
      "localName": "Maria Himmelfahrt",
      "name": "Assumption Day",
      "countryCode": "AT",
      "fixed": true,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-10-26",
      "localName": "Nationalfeiertag",
      "name": "National Holiday",
      "countryCode": "AT",
      "fixed": true,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-11-01",
      "localName": "Allerheiligen",
      "name": "All Saints' Day",
      "countryCode": "AT",
      "fixed": true,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-12-08",
      "localName": "Mariä Empfängnis",
      "name": "Immaculate Conception",
      "countryCode": "AT",
      "fixed": true,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-12-25",
      "localName": "Weihnachten",
      "name": "Christmas Day",
      "countryCode": "AT",
      "fixed": true,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   },
   {
      "date": "2017-12-26",
      "localName": "Stefanitag",
      "name": "St. Stephen's Day",
      "countryCode": "AT",
      "fixed": true,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
         "Public"
      ]
   }
]