# ਏਜੰਸੀਆਂ, ਟੀਮਾਂ ਅਤੇ API

ਏਜੰਸੀਆਂ Agilis 'ਤੇ ਹਰ ਗਾਹਕ ਦੇ ਨਾਮ ਹੇਠ ਇਸ਼ਤਿਹਾਰ ਕਿਵੇਂ ਦਿੰਦੀਆਂ ਹਨ, ਟੀਮ ਭੂਮਿਕਾਵਾਂ, ਬੈਲੈਂਸ ਅਤੇ ਬਿੱਲ ਕਿਵੇਂ ਕੰਮ ਕਰਦੇ ਹਨ, ਅਤੇ Agilis REST API ਕਿਵੇਂ ਵਰਤਣੀ ਹੈ।

**ਸੰਖੇਪ ਵਿੱਚ:** ਏਜੰਸੀ ਆਪਣੇ ਕਾਨੂੰਨੀ ਨਾਮ ਹੇਠ ਇੱਕ ਵਾਰ ਰਜਿਸਟਰ ਕਰਦੀ ਹੈ, ਅਤੇ **ਮੈਂਬਰਾਂ ਨੂੰ ਦਿਖਣ ਵਾਲਾ ਨਾਮ** ਵਿੱਚ ਹਰ ਗਾਹਕ ਦਾ ਨਾਮ ਭਰ ਕੇ ਆਪਣੇ ਗਾਹਕਾਂ ਲਈ ਇਸ਼ਤਿਹਾਰ ਦਿੰਦੀ ਹੈ। ਏਜੰਸੀ ਭੁਗਤਾਨ ਕਰਦੀ ਹੈ, ਬੈਲੈਂਸ ਰੱਖਦੀ ਹੈ ਅਤੇ ਬਿੱਲ ਪ੍ਰਾਪਤ ਕਰਦੀ ਹੈ। ਡਿਵੈਲਪਰ ਇਸ਼ਤਿਹਾਰ ਪੋਰਟਲ ਤੋਂ ਮਿਲੀਆਂ API ਕੁੰਜੀਆਂ ਨਾਲ **Agilis REST API** (https://ads.agilis.dating) ਰਾਹੀਂ ਆਫਰ ਅਤੇ ਸਮਾਗਮ ਬਣਾ ਅਤੇ ਸੰਭਾਲ ਸਕਦੇ ਹਨ; ਟੈਸਟ ਕੁੰਜੀਆਂ ਮੁਫ਼ਤ ਹਨ ਅਤੇ ਇਹਨਾਂ ਨਾਲ ਬਣਾਇਆ ਕੁਝ ਵੀ ਮੈਂਬਰਾਂ ਨੂੰ ਕਦੇ ਨਹੀਂ ਦਿਖਾਇਆ ਜਾਂਦਾ।

## ਏਜੰਸੀਆਂ ਲਈ

1. ਏਜੰਸੀ ਦੇ ਆਪਣੇ ਕਾਨੂੰਨੀ ਨਾਮ ਹੇਠ **ਏਜੰਸੀ ਨੂੰ ਰਜਿਸਟਰ ਕਰੋ**। → [ਰਜਿਸਟਰ ਕਿਵੇਂ ਕਰਨਾ ਹੈ](https://www.agilis.dating/pa/business/guide/register)
2. ਜਦੋਂ ਤੁਸੀਂ ਕੋਈ ਆਫਰ ਜਾਂ ਸਮਾਗਮ ਬਣਾਉਂਦੇ ਹੋ, ਤਾਂ **ਮੈਂਬਰਾਂ ਨੂੰ ਦਿਖਣ ਵਾਲਾ ਨਾਮ** ਵਿੱਚ ਆਪਣੇ **ਮੈਂਬਰਾਂ ਨੂੰ ਦਿਖਣ ਵਾਲਾ ਨਾਮ** ਭਰੋ। ਮੈਂਬਰਾਂ ਨੂੰ ਗਾਹਕ ਦਾ ਨਾਮ ਦਿਖਦਾ ਹੈ, ਤੁਹਾਡਾ ਨਹੀਂ।
3. ਹਰ ਗਾਹਕ ਲਈ ਇਸ਼ਤਿਹਾਰ ਦੇਣ ਵਾਸਤੇ ਤੁਹਾਡੇ ਕੋਲ ਉਸ ਗਾਹਕ ਦੀ ਇਜਾਜ਼ਤ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ। ਇਸ਼ਤਿਹਾਰ ਨਿਯਮ ਅਤੇ ਸ਼ਰਤਾਂ ਅਨੁਸਾਰ ਇਸਦੀ ਜ਼ਿੰਮੇਵਾਰੀ ਏਜੰਸੀ ਦੀ ਹੈ।

**ਭੁਗਤਾਨ ਕੌਣ ਕਰਦਾ ਹੈ, ਅਤੇ ਬਿੱਲ ਕਿਸਨੂੰ ਮਿਲਦਾ ਹੈ**

- ਭੁਗਤਾਨ ਤੁਹਾਡੀ ਏਜੰਸੀ ਦੇ ਖਾਤੇ ਤੋਂ, ਤੁਹਾਡੀ ਏਜੰਸੀ ਦੀ ਬਿਲਿੰਗ ਮੁਦਰਾ ਵਿੱਚ ਹੁੰਦਾ ਹੈ।
- ਤੁਹਾਡੀ ਏਜੰਸੀ ਦੇ ਹਰ ਵਿਅਕਤੀ ਦਾ ਆਪਣਾ ਬੈਲੈਂਸ ਹੁੰਦਾ ਹੈ ਅਤੇ ਉਹ ਉਸੇ ਵਿੱਚੋਂ ਭੁਗਤਾਨ ਕਰਦਾ ਹੈ। ਸੰਸਥਾ ਬੈਲੈਂਸ ਸਭ ਦਾ ਕੁੱਲ ਜੋੜ ਹੈ। → [ਬੈਲੈਂਸ ਕਿਵੇਂ ਕੰਮ ਕਰਦੇ ਹਨ](https://www.agilis.dating/pa/business/guide/pricing)
- ਬਿੱਲ ਅਤੇ ਨਤੀਜੇ ਤੁਹਾਡੀ ਏਜੰਸੀ ਦੇ ਨਾਮ 'ਤੇ ਹੁੰਦੇ ਹਨ, ਹਰ ਭੁਗਤਾਨ ਲਈ ਇੱਕ ਬਿੱਲ, ਤਾਂ ਜੋ ਤੁਸੀਂ ਹਰ ਗਾਹਕ ਨੂੰ ਅੱਗੇ ਬਿੱਲ ਭੇਜ ਸਕੋ।
- ਹਰ ਗਾਹਕ ਦਾ ਖ਼ਰਚਾ ਵੱਖਰਾ ਰੱਖਣ ਲਈ, ਹਰ ਗਾਹਕ ਲਈ ਵੱਖਰਾ ਆਫਰ ਜਾਂ ਸਮਾਗਮ ਵਰਤੋ ਅਤੇ ਉਸਦੇ ਬਿੱਲ ਦੇ ਆਧਾਰ 'ਤੇ ਗਾਹਕ ਨੂੰ ਅੱਗੇ ਬਿੱਲ ਭੇਜੋ।

## ਟੀਮ ਭੂਮਿਕਾਵਾਂ

ਸੰਸਥਾ ਪ੍ਰਬੰਧਕ ਅਤੇ ਇਸ਼ਤਿਹਾਰਦਾਤਾ ਇਸ਼ਤਿਹਾਰ ਪੋਰਟਲ ਵਿੱਚ ਕੰਮ ਕਰਦੇ ਹਨ; ਡਿਵੈਲਪਰ API ਰਾਹੀਂ ਕੰਮ ਕਰਦੇ ਹਨ। ਡਿਵੈਲਪਰ ਇਸ਼ਤਿਹਾਰ ਪੋਰਟਲ ਵਿੱਚ ਆਫਰ ਜਾਂ ਸਮਾਗਮ ਨਹੀਂ ਬਣਾ ਸਕਦੇ, ਪਰ ਆਪਣੀਆਂ API ਕੁੰਜੀਆਂ ਨਾਲ ਉਹ API ਰਾਹੀਂ ਇਹਨਾਂ ਨੂੰ ਬਣਾ ਸਕਦੇ ਹਨ, ਪ੍ਰਕਾਸ਼ਿਤ ਕਰ ਸਕਦੇ ਹਨ ਅਤੇ ਇਹਨਾਂ ਲਈ ਭੁਗਤਾਨ ਕਰ ਸਕਦੇ ਹਨ, ਅਤੇ ਤੁਹਾਡੇ ਕਾਰੋਬਾਰ ਦੀਆਂ ਕੁੰਜੀਆਂ ਦੀ ਵਰਤੋਂ ਦੀ ਜ਼ਿੰਮੇਵਾਰੀ ਤੁਹਾਡੇ ਕਾਰੋਬਾਰ ਦੀ ਹੈ। ਪੂਰੀ ਸਾਰਣੀ [ਟੀਮ ਭੂਮਿਕਾਵਾਂ ਅਤੇ ਇਜਾਜ਼ਤਾਂ](https://www.agilis.dating/pa/business/guide/getting-started) ਵਿੱਚ ਹੈ।

## Agilis REST API

- **ਮੂਲ URL:** https://ads.agilis.dating
- **ਹਵਾਲਾ ਦਸਤਾਵੇਜ਼:** www.agilis.dating/api-doc, cURL, Python, Node.js ਅਤੇ PHP ਵਿੱਚ ਨਮੂਨਿਆਂ ਅਤੇ ਇੱਕ API ਸਹਾਇਕ ਸਮੇਤ
- **ਮਸ਼ੀਨ ਦੁਆਰਾ ਪੜ੍ਹਨਯੋਗ:** OpenAPI 3.1 www.agilis.dating/openapi.json 'ਤੇ, Markdown www.agilis.dating/api-doc.md 'ਤੇ, ਅਤੇ AI ਟੂਲਾਂ ਲਈ ਪੂਰਾ ਪਾਠ www.agilis.dating/llms-full.txt 'ਤੇ
- **ਆਫਰ:** ਆਪਣੀਆਂ ਸ਼੍ਰੇਣੀਆਂ ਅਤੇ ਰੁਚੀਆਂ ਦੀ ਸੂਚੀ ਵੇਖੋ; ਆਫਰ ਬਣਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਉਸਦੀ ਕੀਮਤ ਪਤਾ ਕਰੋ; ਆਫਰ ਬਣਾਓ, ਸੂਚੀਬੱਧ ਕਰੋ, ਰੋਕੋ, ਮੁੜ ਸ਼ੁਰੂ ਕਰੋ ਅਤੇ ਮਿਟਾਓ; ਹਰ ਆਫਰ ਦੇ ਨਤੀਜੇ ਪੜ੍ਹੋ
- **ਸਮਾਗਮ:** ਸਮਾਗਮਾਂ ਦੀ ਝਲਕ ਵੇਖੋ, ਪ੍ਰਕਾਸ਼ਿਤ ਕਰੋ, ਸੂਚੀਬੱਧ ਕਰੋ, ਸੋਧੋ, ਸਮਾਂ ਬਦਲੋ, ਰੱਦ ਕਰੋ ਅਤੇ ਮਿਟਾਓ; ਹਰ ਸਮਾਗਮ ਦੇ ਨਤੀਜੇ ਪੜ੍ਹੋ

### API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ

1. ਸੰਸਥਾ ਪ੍ਰਬੰਧਕ ਜਾਂ ਡਿਵੈਲਪਰ ਵਜੋਂ ਇਸ਼ਤਿਹਾਰ ਪੋਰਟਲ ਵਿੱਚ ਸਾਈਨ ਇਨ ਕਰੋ।
2. ਪੰਨੇ ਦੇ ਸਿਖਰ 'ਤੇ ਦਿੱਤੇ ਸਵਿੱਚ ਨਾਲ **ਟੈਸਟ ਮੋਡ** ਜਾਂ ਲਾਈਵ ਮੋਡ ਚੁਣੋ।
3. **API ਕੁੰਜੀਆਂ** → **ਨਵੀਂ ਕੁੰਜੀ ਬਣਾਓ** 'ਤੇ ਜਾਓ, ਇਸਨੂੰ ਇੱਕ ਨਾਮ ਦਿਓ ਅਤੇ, ਜੇ ਚਾਹੋ ਤਾਂ, ਮਿਆਦ ਪੁੱਗਣ ਦੀ ਤਾਰੀਖ਼ ਵੀ ਦਿਓ।
4. **ਕੁੰਜੀ ਤੁਰੰਤ ਕਾਪੀ ਕਰ ਲਓ।** ਤੁਸੀਂ ਇਸਨੂੰ ਦੁਬਾਰਾ ਨਹੀਂ ਦੇਖ ਸਕੋਗੇ।

ਟੈਸਟ ਕੁੰਜੀਆਂ `pk_test_` ਨਾਲ ਸ਼ੁਰੂ ਹੁੰਦੀਆਂ ਹਨ; ਲਾਈਵ ਕੁੰਜੀਆਂ `pk_live_` ਨਾਲ। ਹਰ ਵਿਅਕਤੀ ਹਰ ਮੋਡ ਵਿੱਚ ਵੱਧ ਤੋਂ ਵੱਧ 10 ਕੁੰਜੀਆਂ ਰੱਖ ਸਕਦਾ ਹੈ। **ਕੁੰਜੀ ਬਦਲੋ** ਕੁੰਜੀ ਨੂੰ ਤੁਰੰਤ ਬਦਲ ਦਿੰਦਾ ਹੈ, ਇਸ ਲਈ ਪਹਿਲਾਂ ਆਪਣੇ ਸਿਸਟਮ ਅੱਪਡੇਟ ਕਰੋ। ਕੁੰਜੀ ਨੂੰ `x-api-key` ਰਿਕਵੈਸਟ ਹੈਡਰ ਵਿੱਚ ਭੇਜੋ: `x-api-key: pk_test_…`।

### ਸੁਰੱਖਿਅਤ ਢੰਗ ਨਾਲ ਬਣਾਓ

- `pk_test_` ਕੁੰਜੀ ਨਾਲ ਬਣਾਓ ਅਤੇ ਟੈਸਟ ਕਰੋ: ਟੈਸਟ ਆਫਰ ਅਤੇ ਸਮਾਗਮ ਮੁਫ਼ਤ ਹਨ ਅਤੇ ਮੈਂਬਰਾਂ ਨੂੰ ਕਦੇ ਨਹੀਂ ਦਿਖਾਏ ਜਾਂਦੇ।
- ਆਫਰ ਬਣਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਕੀਮਤ-ਅਨੁਮਾਨ ਐਂਡਪੁਆਇੰਟ ਨਾਲ ਉਸਦੀ ਕੀਮਤ ਪਤਾ ਕਰੋ।
- ਕੁੰਜੀਆਂ ਨੂੰ ਕੋਡ ਰਿਪੋਜ਼ਟਰੀਆਂ ਅਤੇ ਬ੍ਰਾਊਜ਼ਰਾਂ ਤੋਂ ਦੂਰ ਰੱਖੋ; API ਨੂੰ ਆਪਣੇ ਸਰਵਰ ਤੋਂ ਕਾਲ ਕਰੋ।

## ਸਵਾਲ

### ਕੀ ਇੱਕ ਏਜੰਸੀ ਇੱਕੋ ਖਾਤੇ ਤੋਂ ਕਈ ਗਾਹਕਾਂ ਦਾ ਪ੍ਰਬੰਧ ਕਰ ਸਕਦੀ ਹੈ?

ਹਾਂ। ਏਜੰਸੀ ਨੂੰ ਇੱਕ ਵਾਰ ਰਜਿਸਟਰ ਕਰੋ ਅਤੇ ਹਰ ਆਫਰ ਜਾਂ ਸਮਾਗਮ 'ਤੇ ਗਾਹਕ ਦਾ ਨਾਮ ਭਰੋ।

### ਕੀ ਹਰ ਗਾਹਕ ਦਾ ਆਪਣਾ ਵੱਖਰਾ ਬਿੱਲ ਹੋ ਸਕਦਾ ਹੈ?

ਬਿੱਲ ਤੁਹਾਡੀ ਏਜੰਸੀ ਦੇ ਨਾਮ 'ਤੇ ਜਾਰੀ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਹਰ ਭੁਗਤਾਨ ਲਈ ਇੱਕ। ਇਹਨਾਂ ਦੇ ਆਧਾਰ 'ਤੇ ਆਪਣੇ ਗਾਹਕਾਂ ਨੂੰ ਅੱਗੇ ਬਿੱਲ ਭੇਜੋ।

### ਕੀ ਕੋਈ ਸੈਂਡਬਾਕਸ ਹੈ?

ਹਾਂ। `pk_test_` ਕੁੰਜੀਆਂ ਵਾਲਾ ਟੈਸਟ ਮੋਡ ਇੱਕ ਪੂਰਾ ਸੈਂਡਬਾਕਸ ਹੈ। ਕੋਈ ਖ਼ਰਚਾ ਨਹੀਂ ਲਿਆ ਜਾਂਦਾ ਅਤੇ ਮੈਂਬਰਾਂ ਨੂੰ ਕੁਝ ਵੀ ਨਹੀਂ ਦਿਖਾਇਆ ਜਾਂਦਾ।

### ਕੀ AI ਕੋਡਿੰਗ ਟੂਲ ਜੋੜੇ ਜਾ ਸਕਦੇ ਹਨ?

ਹਾਂ। ਆਪਣੇ ਟੂਲ ਨੂੰ www.agilis.dating/api-doc.md ਜਾਂ www.agilis.dating/openapi.json ਵੱਲ ਨਿਰਦੇਸ਼ਿਤ ਕਰੋ।

Source: https://www.agilis.dating/pa/business/guide/agencies-and-api