{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"be76d1e7-014c-41f3-b826-f55a9121dcfc","name":"contety API","description":"## Giriş\n\ncontety API servisi RESTful mimarisini kullanılır ve yapay zeka ile içerik oluşturmak için çeşitli endpoint'ler sunar.\n\n## Gereksinimler\n\ncontety API servisini kullanabilmek için:\n\n1. contety hesabınız\n    \n2. API erişim özelliği olan aktif bir paketiniz\n    \n3. Bir API keyiniz olması gerekmektedir.\n    \n\n---\n\n## API Keyleri\n\nAPI keylerinizi contety hesabınıza giriş yaptıktan sonra [contety API Keylerim](https://app.contety.com) sayfasından oluşturabilirsiniz.\n\n---\n\n## Authentication\n\ncontety API, authentication işlemi için API keylerini kullanır. API endpoint'lerine yapılacak tüm isteklerde ilgili API key `Authorization` header ile gönderilmelidir.\n\n```\nAuthorization: Bearer YOUR_SECRET_API_KEY\n\n ```\n\n---\n\n## Request format\n\nconcety API bir JSON API olduğu için endpoint'lere yapılacak tüm isteklerde `Accept` header bilgisinde `application/json` değeri gönderilmelidir.\n\n```\nAccept: application/json\n\n ```\n\n---\n\n## Response Format\n\nDönen her başarılı cevapta `result` değişkeni `success` değerini alır ve ilgili bilgiler `data` attribute içinde listelenir. Eğer `result` değişkeni `success` değerinden farklı bir değer ise ilgili işlemde bir hata olduğu kabul edilmelidir.\n\n``` json\n{\n    \"result\": \"success\",\n    \"data\": \"...\"\n}\n\n ```\n\n---\n\n## Hatalar\n\ncontety API bir hata durumunda ilgili HTTP kodu ile birlikte bir hata mesajı döner. Örnekler:\n\n**400 Bad Request**\n\n**401 Unauthorized**\n\n**403 Forbidden**\n\n**404 Not Found**\n\n**405 Method Not Allowed**\n\n**406 Not Acceptable**\n\n**422 Unprocessable Content**\n\n**429 Too Many Requests**\n\n**500 Internal Server Error**\n\n``` json\n{\n    \"message\": \"hata ile ilgili bir mesaj\"\n}\n\n ```\n\n---\n\n## Rate Limits\n\nGET requestlerinde dakikada 20, POST requestlerde ise dakikada 10 request limiti bulunmaktadır ve tüm API cevapları `X-Rate-Limit` ve `X-Rate-Limit-Remaining` header'larını içermektedir. Bu bilgiler ilgili dakikadaki request limitinizi gösterir. Limit aşıldığında `429 Too Many Requests` kodu ile bir cevap döner.\n\n```\nX-Rate-Limit: 20\nX-Rate-Limit-Remaining: 19\n\n ```\n\n---\n\n## Callback İşlemleri\n\ncontety API servisindeki bazı şablonlarda içerikler hemen oluşturulmaz ve oluşturulmak için işlem sırasına alınırlar. Bu şablonlar aşağıdaki listelenmiştir:\n\n1. Wordpress Makalesi\n    \n2. Wordpress Rüya Tabiri\n    \n3. Yemek Tarifi\n    \n4. Makale\n    \n5. Metin Özgünleştirme\n    \n\nBu şablonları kullanarak bir içerik oluşturmak istediğinizde, içerik işlem sırasına alınır ve oluşturulma işlemi tamamlandığında API keyinize ait callback URL adresine bir POST request yapılır. Bu URL adresinizi contety hesabınıza giriş yaptıktan sonra **contety API keylerim** sayfasından belirleyeblirsiniz.\n\nBu URL adresi dışarıdan erişime açık ve herhangi bir authorization işlemi gerektirmeyen public bir URL olmalıdır.\n\n> **ÖNEMLİ HATIRLATMA**  \nCallback URL belirlenmeyen API keyler için herhangi bir callback işlemi yapılamayacaktır. Bu nedenle iş akışınızın aksamaması için lütfen callback URL belirlemeyi unutmayın. \n  \n\n## Başarılı İşlem İçin İş Akışı:\n\nEğer işlem sırasına alınma sırasında bir sorun olmazsa `202 Accepted` kodu ile bir cevap döner. Dönen cevapta içeriğin `status` değeri `processing` olarak görüntülenir. Örnek cevaplara her bir şablonun ilgili endpoint'ine ait dokümantasyon bölümünden ulaşabilirsiniz.\n\nİçeriğin oluşturulması tamamlandığında API keyinize ait callback URL adresine bir POST request yapılır. Bu aşamadan sonra artık **İçerik Bilgileri** enpoint'ine bir request yaparak içeriğiniz ile ilgili tüm bilgilere ulaşabiirsiniz.\n\nBu bilgilerdeki `status` değeri `completed` ise içeriğinizin oluşturulması tamamlanmış anlamına gelir ve içeriğe ait tüm bilgiler JSON formatında döner. Eğer `status` değeri `failed` ise içerik oluşturulamamış anlamına gelir.\n\n## Başarısız İşlem İçin İş Akışı:\n\nEğer içeriğiniz kaydedilir ama işlem sırasına alınma sırasında bir hata meydana gelirse `201 Created` kodu ile bir cevap döner. Dönen cevapta içeriğin `status` değeri `failed` olarak görüntülenir. Örnek cevaplara her bir şablonun ilgili endpoint'ine ait dokümantasyon bölümünden ulaşabilirsiniz.\n\nBu d,urumda herhangi bir callback işlemi yapılmaz.\n\n## Callback Request\n\nYapılan callback request aşağıdaki bilgileri içeren bir POST requesttir. Aşağıdaki gibi bir bilgi `Content-Type: application/json` header bilgisi ile callback URL adresine body içinde POST edilir.\n\n**Örnek Json Request Formatı:**\n\n``` json\n{\n    \"process_type\": \"content\"\n    \"content_id\": 12345\n    \"status\": \"completed\"\n}\n\n ```\n\nVEYA\n\n``` json\n{\n    \"process_type\": \"content\"\n    \"content_id\": 12345\n    \"status\": \"failed\"\n}\n\n ```\n\n---\n\n## Yapay Zeka Modelleri\n\nİçerik oluşturma işlemi sırasında kullanılabilecek değerler:\n\n1. `chatgpt3.5_turbo`\n    \n2. `chatgpt4_turbo`\n    \n3. `gpt4o`\n    \n4. `gpt4o_mini`\n    \n5. `gpt4_1`\n    \n6. `gpt4_1_mini`\n    \n7. `gpt4_1_nano`\n    \n8. `gpt5`\n    \n9. `gpt5_1`\n    \n10. `gpt5_2`\n    \n11. `gpt5_4`\n    \n12. `gpt5_mini`\n    \n13. `gpt5_nano`\n    \n14. `gpt5_4_nano`\n    \n15. `gpt5_4_mini`\n    \n16. `openai_o3_mini`\n    \n17. `openai_o4_mini`\n    \n18. `gemini_2.5_flash`\n    \n19. `gemini_2.5_flash_thinking`\n    \n20. `gemini_2.5_pro`\n    \n21. `gemini_3_flash`\n    \n22. `gemini_3.1_flash_lite`\n    \n23. `gemini_3.1_pro`\n    \n\nAncak bu değerler aktif paketinizin planına göre değişiklik gösterebilir.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"31110887","collectionId":"be76d1e7-014c-41f3-b826-f55a9121dcfc","publishedId":"2sA3JJA3Sj","public":true,"publicUrl":"https://documenter-api.postman.tech/view/31110887/2sA3JJA3Sj","privateUrl":"https://go.postman.co/documentation/31110887-be76d1e7-014c-41f3-b826-f55a9121dcfc","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"contety API dokümantasyonu"},{"name":"title","value":""}],"appearance":{"default":"system_default","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2024-05-12T20:08:16.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":"contety API dokümantasyonu"},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"contety API ENV","id":"b77c5c4a-9f59-475f-8b75-45a096d8df29","owner":"31110887","values":[{"key":"api_key","value":"{secret_api_key}","enabled":true,"type":"default"},{"key":"base_url","value":"https://api.contety.com/v1","enabled":true,"type":"default"},{"key":"content_id","value":"{content_id}","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"contety API ENV","value":"31110887-b77c5c4a-9f59-475f-8b75-45a096d8df29"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sA3JJA3Sj"}