# Islam AI (islamicity.org) — Zapi reference > Asisten AI percakapan khusus topik Islam — fiqih, tafsir, hadits, sirah. OpenAI-compatible, support streaming. **Base URL:** `https://api.zpi.web.id` **Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys. **Response envelope:** `{ status, message, content }` **Rate limit:** 60 req/min on free tier. **Related:** - Detail page: https://zpi.web.id/api/ai/islamicity - Endpoint catalog: https://zpi.web.id/category/ai - Concise index: https://zpi.web.id/llms.txt - Full reference: https://zpi.web.id/llms-full.txt --- ## Islam AI (islamicity.org) **Category:** ai · **Slug:** `islamicity` **Detail page:** https://zpi.web.id/api/ai/islamicity Asisten AI percakapan khusus topik Islam — fiqih, tafsir, hadits, sirah. OpenAI-compatible, support streaming. **Tags:** ai, chat, islam ### Chat Completion - **Method:** `POST` - **Endpoint:** `https://api.zpi.web.id/v1/ai:islamicity/chat` **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `messages` | array | body | yes | OpenAI-format message history. Khusus untuk pertanyaan seputar Islam. | | `stream` | boolean | query | no | Stream response via SSE delta. Default false | **cURL:** ```bash curl -X POST "https://api.zpi.web.id/v1/ai:islamicity/chat" \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "messages": [ { "role": "system", "content": "Kamu adalah ustadz bernama Islam AI." }, { "role": "user", "content": "Halo, perkenalkan dirimu dalam 1 kalimat." } ] }' ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/ai:islamicity/chat", { method: "POST", headers: { "x-api-key": process.env.ZAPI_KEY, "Content-Type": "application/json" }, body: JSON.stringify({ "messages": [ { "role": "system", "content": "Kamu adalah ustadz bernama Islam AI." }, { "role": "user", "content": "Halo, perkenalkan dirimu dalam 1 kalimat." } ] }) }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.post("https://api.zpi.web.id/v1/ai:islamicity/chat", headers={"x-api-key": "YOUR_API_KEY"}, json={ "messages": [ { "role": "system", "content": "Kamu adalah ustadz bernama Islam AI." }, { "role": "user", "content": "Halo, perkenalkan dirimu dalam 1 kalimat." } ] }) data = r.json() ``` **Example response:** ```json { "id": "chatcmpl-ouk8WCZgXhoLMohdqMBeBBcc", "model": "chatilm", "usage": { "total_tokens": 4573, "prompt_tokens": 4245, "completion_tokens": 328, "prompt_tokens_details": { "audio_tokens": 0, "cached_tokens": 4224 }, "completion_tokens_details": { "audio_tokens": 0, "reasoning_tokens": 0, "accepted_prediction_tokens": 0, "rejected_prediction_tokens": 0 } }, "object": "chat.completion", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hukum bagi seorang programmer untuk naik haji adalah sama dengan hukum bagi setiap Muslim yang memenuhi syarat untuk melaksanakan ibadah haji. Haji adalah salah satu rukun Islam yang wajib dilaksanakan oleh setiap Muslim yang mampu secara fisik dan finansial, sebagaimana dijelaskan dalam Al-Qur'an:\n\n\"Dan Allah mewajibkan manusia untuk mengerjakan haji ke Baitullah, bagi yang mampu mengadakan perjalanan ke sana.\" [Quran 3:97]\n\nSeorang programmer, seperti halnya individu lainnya, harus memenuhi syarat-syarat berikut untuk melaksanakan haji:\n\n1. **Kemampuan Finansial**: Memiliki cukup dana untuk perjalanan dan biaya hidup selama di Makkah.\n2. **Kemampuan Fisik**: Dalam keadaan sehat dan mampu melakukan rukun-rukun haji.\n3. **Waktu**: Melaksanakan haji pada waktu yang ditentukan, yaitu pada bulan Dzulhijjah.\n\nJika seorang programmer memenuhi semua syarat di atas, maka tidak ada larangan untuk melaksanakan haji. Bahkan, melaksanakan haji adalah suatu kewajiban yang sangat dianjurkan dan merupakan kesempatan untuk mendapatkan pahala yang besar. \n\nNamun, jika pekerjaan sebagai programmer mengharuskan untuk terlibat dalam aktivitas yang haram atau tidak sesuai dengan prinsip-prinsip Islam, maka sebaiknya dia memperbaiki situasi kerjanya sebelum melaksanakan haji. Sebagaimana disebutkan dalam banyak fatwa, penting untuk memastikan bahwa sumber penghasilan adalah halal agar ibadah yang dilakukan diterima oleh Allah. \n\nAllah Maha Mengetahui yang terbaik.", "refusal": null, "tool_calls": null, "annotations": [], "function_call": null }, "logprobs": null, "finish_reason": "stop" } ], "context": { "link": {}, "text": "the religious ruling in this regard. Hence, it is allowed to work in this field, Allah willing. Allah knows best.\\n\", '\\n', '\\n', 'Question nbr: 114517\\n', 'Toipc: Working as programmer in shipping company\\n', 'Question: I work for a shipping company as a programmer. My job requires me to create a program which takes in information about the item being shipped and stores it somewhere else. I do not see what items are being shipped nor who is doing so. I just make the program that will automatically do this job. In this program, I am required to provide fields, such as the shipper\\'s name, address, etc., and also information about the item being shipped, such as weight, size, etc. One of the fields which I must put in the program is called the \"insurance amount\". This field will contain the amount which the shipper paid to insure the item. Is my work haram?\\n', \"Answer: All perfect praise be to Allah, the Lord of the worlds. I testify that there is none worthy of worship except Allah and that Muhammad (saw) is His slave and Messenger.Your work as a programmer in a shipping company, designing a program through which information about the shipped goods is entered, seems to be permissible, because in principle working in creating programs and systems that may be used in both lawful and unlawful activities is permissible unless it is known for sure or it is predominantly thought that the program will be used for unlawful purposes.Therefore, there is no harm in the work which you mentioned unless the company's activity is related to shipping what is impermissible to be shipped; in which case, it would be forbidden to help it in doing so, and you did not mention this in your question (whether the shipped goods are lawful or not). Allah knows best.\\n\", '\\n', '\\n', 'Question nbr: 114518\\n', \"Toipc: Ruling on money from India's NPS retirement pension\\n\", \"Question: Assalaamu alaykum. I am a government employee in Karnataka, India. There is a new retirement pension scheme called NPS; it is obligatory for everyone. In this plan, 10% of our basic salary is deducted every month, and a same amount is deposited from the govenment side to a separate account. This amount is utilized by the government on the stock market, which I think is unlawful.\n\nprograms is a Muslim or non-Muslim individual, or a Muslim or non-Muslim state. However, if a non-Muslim state is engaged in fighting Muslims, it is permissible to take their property as spoils of war. This stance is based on the following Quranic verses: \"O ye who believe! Fulfil your undertakings.\" (Al-Maidah: 1) “Wring not mankind in their goods.” (Ash-Shu`ra\\': 183) “O ye who believe! Betray not Allah and His messenger, nor knowingly betray your trusts.\" (Al-Anfal: 27) Likewise, the following Hadiths support this stance: \"(Keep and) pay back the trusts of those who entrust you.\" \"The true believer is the one from whom Muslims are safe regarding their blood and property.\" As for copying computer programs for educational purposes, it is permissible in case of necessity, i.e., if it is difficult to obtain an original copy of this program or its price is too expensive. This is in accordance with the following Quranic verses: “Unless ye are compelled thereto.” (Al-An`am: 119) “But he who is driven by necessity, neither craving nor transgressing, it is no sin for him. Lo! Allah is Forgiving, Merciful.” (Al-Baqarah: 173) Finally, the above-mentioned legal rulings extend, by virtue of analogical deduction qiyas, to making copies of CDs and all similar items.” If you are still in need of more information, dont hesitate to contact us. Do keep in touch. May Allah guide us all to the straight path! Wassalam and Allah Almighty knows best. \\n', '\\n', '\\n', 'Question nbr: 7447\\n', 'Toipc: Marriage: Problems\\n', 'Question: As Salamu Alaikum Rahmatulah wa Barakatu. My husband has three children from a previous marraige, of whom he pays quite a bit of child support for. Shortly after we had our nikah we found out that he had another child on the way from a woman to whom he was not married to.I was very shocked and disappointed to hear this news. I am still trying to adapt to having this other child and his mother in our life. He also supports this child as well, as he should. Since we have been married we had a child together. Along with all of his\n\nof the software used here is also pirated, but most of my work is done using custom software that has been developed by the company itelf, though I sometimes have to work on MS Office and other proprietary software and also have to support other employees who use that as well. What is the ruling on that; is my income haram because of that? Kindly also note, as I have said above, that almost every company use pirated software, so I am in a really difficult situation in the end. I am sorry for taking so much of your precious time. May Allaah reward you with good.\\n', 'Answer: All perfect praise be to Allah, The Lord of the worlds. I testify that there is none worthy of worship except Allah and that Muhammad, sallallahu \\'alayhi wa sallam, is His slave and Messenger. Our advice to you is to not work in a job in which you would most likely have to use whatever you believe to be unlawful. You should seek another job that is void of such prohibitions. You should know that whoever sincerely seeks what is lawful and good, Allah guides him to it; and whoever keenly avoids evil, Allah guards him against it, as the Prophet, sallallahu \\'alayhi wa sallam, said. By keenly striving in looking for another job free of such Shariah violations, and by imploring Allah sincerely to help you, you will find that job, Allah willing. The fatwa adopted at Islamweb is that it is prohibited to use pirated programs in order to preserve and respect the rights of their owners and given the consequent harms caused to them as a result of using such programs.The Council of the Islamic Fiqh Academy in 1405 AH about \"Incorporeal rights\" resolved that copyrights and patent rights are protected by the Shariah. These rights are recognized by the Shariah and should not be infringed upon, and their holders are entitled to freely dispose of them. It is impermissible to violate these rights.Hence, you should strive and do your best to find a job where you do not need to use such pirated programs. If you sign a contract to do a lawful job and then you happened to use pirated software programs at work, your salary is lawful but you bear a sin for the unauthorized use of these programs.For more benefit, please, refer to fatwa 159509.Allah knows best.\\n',\n\nwa bihamdihi subhanakallahumma wa bihamdika wa nash hadu alla ilaha illa anta nastaghfiruka wa natubu ilayk\". If you are still in need of more information, dont hesitate to contact us. Do keep in touch. May Allah guide us all to the straight path! Wassalam and Allah Almighty knows best. \\n', '\\n', '\\n', 'Question nbr: 7716\\n', 'Toipc: Buying and Selling: Software\\n', 'Question: Asalamwalikum, I am a computer programmer, who has a job offer from a company that makes video Chat, Rich Media and eCommerce systems. I have come to find out that some of the companies clients use this software for non halal purposes (adult sites). I told the software company that I wouldnt do any software support for those clients and the company is alright with that. But some software issues are related to the product as a whole, so if i fix something in the software the fix will also appear in the clients sites that arnt halal. Is it haram or halal to take this job offer? Asalamwaikum\\n', 'Answer: As-Salamu `alaykum wa Rahmatullahi wa Barakatuh. In the Name of Allah, Most Gracious, Most Merciful. All praise and thanks are due to Allah, and peace and blessings be upon His Messenger. We commend your keenness on getting yourself well-acquainted with Islam and its teachings, and we implore Allah Almighty to help us serve His cause and render our work for His Sake. If whatever software you are developing does not involve any Haram thing in itself then there is no harm. But Allah(swt) says: \"Help ye one another in righteousness and piety, but help ye not one another in sin and rancour: fear Allah. For Allah is strict in punishment. \"(Holy Quran 5:02) If you are still in need of more information, dont hesitate to contact us. Do keep in touch. May Allah guide us all to the straight path! Wassalam and Allah Almighty knows best. \\n', '\\n', '\\n', 'Question nbr: 8084\\n', 'Toipc: Purification: Ghusl\\n', 'Question: salaam. my question is if u take a shower do u have to make wudu afterwards\n\nnot known to the heirs. It is known that these rights come in priority over the right of the heirs in the inheritance. Therefore, the inheritance should not be divided without referring to an Islamic court, if any, in order to fulfill the interests of both the dead and the living. Allaah Knows best.\\n', '\\n', '\\n', 'Question nbr: 115130\\n', 'Toipc: Violating licensing conditions of software programs\\n', \"Question: Assalamu alaikum. Is the money obtained from developing/making software using haram tools(e.g. pirated software, illegal internet connection, illegal electricity connection, computer bought using ill gotten money, and so on) haram? If a vendor of a software I bought stated in the license that I can't make more than one copy of the software for backup purposes and I made more than one copy or I can't use the software for gaining unauthorized access to networks, data, accounts, or services and I use it to do those things, am I still allowed to use the software if the vendor said that doing those acts will terminate the license? Are they valid conditions? If they are valid conditions and I still used the software after termination of license for earning money, is the money haram? If the money obtained is haram then will all the things I bought using those money be haram also? If I used fake school papers and other required papers to apply for a job and I got accepted, will the money from my salary be haram? I hope to hear from you soon. Wassalamu alaikum.\\n\", 'Answer: All perfect praise be to Allaah, The Lord of the Worlds. I testify that there is none worthy of worship except Allaah, and that Muhammad (saw) is His slave and messenger. With regard to the first part of your question regarding the violation of the terms and conditions of the owner of the software program, according to the preponderant opinion, it is an obligation to abide by those terms and it is not permissible to violate them. These conditions imply the possession of a utility to utilize it according to a determined extent and a specific manner. Based on such conditions, the contract has been concluded and agreed upon. So, violating such conditions constitutes a breach of the intellectual rights.As for whatever was gained by way of using copied programs or violated utilities such as networks or electricity or a device purchased with forbidden wealth, the general\n\nan oath and one witness.\" [Ahmad and Ibn Maajah] Allah knows best.\\n', '\\n', '\\n', 'Question nbr: 114406\\n', 'Toipc: Developing software that might be used in selling unlawful food items\\n', \"Question: I work for a software company as a senior software engineer. My company, let us call it Company X develops a software for Company Y, which is another software company located in US. The service which we provide eventually generates some report using millions of pieces of data to aid big organizations to take their business decisions. Company Y sells our software service to another food supplyer company, Company Z. So Company Z can generate reports using various customers, products, manufacturers, and distributors. A customer can buy various food items which may have many manufacturers and distributors. The problem is that the food items may contain some haram items, like alchohol, pork, etc., along with many halal items, like fruits, chicken, beef, etc. I actually work in the back-end team, where I do not have any idea whether the item is halal or haram. The only thing that I know is some code of those items. When we finish our back-end part, we develop some API's (application programming interface). Another team develops the front-end part, and they use our API's to generate reports using the back-end logic. I also need to test the front-end part. When I started testing the front-end, I saw some food items, including alchohol and pork, because in the front-end, we do not use the code anymore; we use the respective items' descriptions. So my question is: is it halal for me to work in Company X and help develop that software, which may help some third party organization to buy and sell some halal and haram things, though I am not directly connected with the buying and selling?\\n\", 'Answer: All perfect praise be to Allah, the Lord of the worlds. I testify that there is none worthy of worship except Allah and that Muhammad, sallallaahu alayhi wa sallam, is His slave and Messenger.Based on our understanding of your question, we do not believe that there is any objection to your working in the company to which you referred as X and developing those software programs for it.Allah knows best.\\n', '\\n', '\\n', 'Question nbr: 114407\\n',\n\nto buy real student versions of some engineering software with my own money. However, the software forces you to agree to the condition that you cannot use it for academic research! To avoid this issue, I applied a trick to use pirated software. For the software that I could not buy, I would download the older versions of the software, which are not in the market and of which the copyright dates have expired. For example, we are now in 2016, so I downloaded software from 2014; its copyright says 2014-2015. That means that its copyright terminated in 2015. Thus, I am not doing any damage to their business, nor am I breaking the copyright laws. Is this trick halal? And if not, then what should we do?\\n\", 'Answer: All perfect praise be to Allah, The Lord of the worlds. I testify that there is none worthy of worship except Allah and that Muhammad (saw) is His slave and Messenger. If the period of validity has expired, meaning that the software programs are no longer copyrighted by virtue of intellectual property right or that the owner has given permission for copying it in writing or that this is the customary practice, then there is nothing wrong with copying it in this case.In order to know whether or not the copyright still exists and whether or not there is permission of either type [mentioned above], one can refer to the terms and conditions of use as well as ask the specialists in intellectual property copyright.Allah knows best.\\n', '\\n', '\\n', 'Question nbr: 114637\\n', 'Toipc: Division of inheritance among wife, father, and one daughter\\n', 'Question: Assalaamu alaykum. Please calculate the inheritance according to the following information:- Does the deceased have male relatives who are entitled to inherit: (A father)- Does the deceased have female relatives who are entitled to inherit: (A daughter) Number 1 (A wife) Number 1- Additional information: The deceased left an estate worth 8,000,000.\\n', 'Answer: All perfect praise be to Allah, The Lord of the worlds. I testify that there is none worthy of worship except Allah and that Muhammad (saw) is His slave and Messenger. If the heirs are only those mentioned in the question and the deceased did not leave any other heir, then the wife gets one eighth as her legal share due to the existence of direct heirs\n\ndifficult for me to perform it in the future. In short, is my salary completely haram, or is it a mix of halal and haram? I joined the bank just on the basis of my programming skills and had no intention to become a banker. Thank you.\\n', 'Answer: All perfect praise be to Allah, The Lord of the worlds. I testify that there is none worthy of worship except Allah and that Muhammad (saw) is His slave and Messenger.It is absolutely impermissible to work in interest-based banks, even if one\\'s work is not connected to loans, and regardless of whether it be in programming or otherwise, because the different kinds of work there complement each other. We have already issued fatwa 100314 clarifying that it is forbidden to work in programming the systems of interest-based banks and that this is related to interest and helps in it. The salary is dependent on the work. Since the work is forbidden, then what is earned from it is also forbidden. However, some scholars hold the view that if someone worked in an interest-based bank while not knowing that it is forbidden, then he may benefit from his previous salaries. Shaykh Ibn Baaz said in his fatwa about it:\"…The salaries that you had previously earned are lawful for you if you were ignorant of the Shariah ruling; as Allah says (what means): {But Allah has permitted trade and has forbidden interest. So whoever has received an admonition from his Lord and desists may have what is past, and his affair rests with Allah. But whoever returns to [dealing in interest or usury] - those are the companions of the Fire; they will abide eternally therein. Allah destroys interest and gives increase for charities. And Allah does not like every sinning disbeliever.} [Quran 2: 275-276] However, if you knew that this work is not permissible for you, then you must spend the equivalent of what you had earned from your salaries in charitable projects and in helping the poor. You must also repent to Allah, The Almighty, as whoever sincerely repents to Allah, Allah accepts his repentance and forgives his sins.\"Therefore, if you were not aware of the prohibition, you can benefit from your previous salaries, whether in Hajj or otherwise, but if you were aware of the prohibition, then it is not permissible for you to benefit from your salaries, and you have to get rid of" }, "created": 1779551917 } ``` --- _Generated: 2026-08-02T14:24:30.084Z_